使 用 App Inventor 2 开发 出 界面 丰富 、 功 能 强大 的 应 用 


© 介绍 App Inventor 2 的 源码 ©. 掌握 App Inventor 2 插件 的 开发 
© 介绍 Android 的 相关 知识 © 提供 丰富 的 开发 样 例 
© 学 会 App Inventor 2 自 带 组 件 的 功能 扩展 


App Inventor 2 
EMIS KH 


mt Le © Ai 


机 械 工 业 出 版 社 


CHINA MACHINE PRESS 


App Inventor 2 定制 与 
一 次 开发 


强 增 编著 


© 


机 械 工 业 出 版 社 


的 


训 人 员 ， 学 习 App Inventor 2 


本 书 介绍 了 App Inventor 2 
牛 的 功能 扩展 和 
发 相关 知识 
E 此 基础 上 ， 
功能 更 强大 的 应 用 。 
有 App Inventor 2 开发 教 
发 的 学 生 和 
2 的 初学 者 ， 还 是 中 高 级 读者 ， 本 书 都 是 一 本 不 可 多 得 的 


源码 、 自 
App Inventor 2 
制 与 二 次 开发 ， 


带 组 


A 


发 涉及 
重 件 的 开发 ， 并 提供 


的 Android 相关 知识 ，App Inventor 2 


了 大 量 实例 ， 使 读者 对 


A 


个 全 面 了 解 ， 能 


=x 
An 
He 


ABA (CIP) 数据 


App Inventor2 jE t 


2018.6 
ISBN 978-7-111-59828-2 


p 


够 


Xt App Inventor 2 进行 


以 更 专业 和 


高 


效 的 方式 开发 出 UI 界 


、 培 训 工作 的 教师 和 培 


发 人 员 等 。 


无 论 是 App Inventor 


发 / 强 增 编著 . 一 北京 : 机 械 工业 出 版 社 ， 


1. OAs IL. @ 强 … M. 四 移动 终端 一 应 用 程序 一 程序 设计 

IV. OTN929.53 

中 国 版 本 图 书馆 CIP 数据 核 字 (2018) 第 088371 号 

机 械 工业 出 版 社 〈 北 京 市 百 万 庄 大街 22 号 “邮政 编码 100037) 

策划 编辑 : 汤 机 责任 编辑 : 汤 机 

责任 校对 : TREE 责任 印 制 : 常 天 培 

北京 圣 夫 亚 美 印 刷 有 限 公 司 印 刷 

2018 年 6 月 第 1 版 .第 1 次 印刷 

184mmX260mm。15.75 印张 。376 生字 

0001—2500 

标准 书号 : ISBN 978-7-111-59828-2 

定价 : 59.00 元 

凡 购 本 书 ， 如 有 缺 页 、 倒 页 、 脱 页 ， 由 本 社 发 行 部 调换 

电话 服务 网 络 服 务 

服务 咨询 热线 ，(010) 88379833 ”机 工 官网 : www.cmpbook.com 
机 工 官 博 : weibo.com/cmp1952 

读者 购书 热线 : 

读者 购书 热线 : (010) 88379649 教育 服务 网 : ee E 

封面 无 防伪 标 均 为 盗版 & P 网 : www.golden-book.com 


前 


2017 年 7 H 20 日 国务 院 印 发 了 《新 
成 为 国际 竞争 的 新 焦点 ， 应 逐步 


一 


»a 
—- 
= 
rt 


Ak 


代 人 工 智能 


BAL 
展 全 民智 能 教育 项 目 ， 在 ， 


程 ， 逐 步 推广 编程 教育 ， 建 设 人 工 智 外 


地 ; 并 强调 大 力 加 强人 ] 
富 教 于 乐 的 编程 教学 软件 、 游 戏 的 开 
此 次 规划 的 出 台 ， 必 将 加 快 编程 教育 

相关 行业 的 发 展 。 

App Inventor 2 是 起 源 于 Google, Jr 
它 抛弃 了 复杂 的 程序 代码 ， 
各 适合 学 生 和 非 专业 软件 开发 人 员 使 用 。 


[智能 劳动 力 培 训 ，/ 
发 和 推广 。 
进入 中 小 学 和 职 


Google 也 在 和 各 教育 部 门 合作 ， 大 力 


泛 开 


E 学 科 ， 培 养 复 合 型 人 才 ， 形 成 我 
展 人 工 智能 科普 活动 ， 鼓 


MAA 


MIT (WE 


展 规划 》 其 中 明确 指出 人 工 智 能 
小 学 阶段 设置 人 工 智 


?能 相关 课 


里 工学 院 ) 开发 的 一 款 


国人 工 智能 人 才 高 
励 社会 力量 参与 


课堂 的 实施 进度 ， 从 而 促进 


名 


形 化 编程 工 


只 需要 拖 动 和 排列 积木 形状 的 模块 就 可 以 编写 各 种 应 用 ， 非 


E App Inventor 2 编程 开发 ， 已 经 有 许多 学 校 、 


大 学 和 社会 培训 机 构 开 设 了 App Inventor 2 编程 课程 。 

目前 介绍 App Inventor 2 开发 相关 的 书籍 很 多 ， 但 基本 是 单纯 介绍 使 用 App Inventor 2 开 
发 应 用 ; App Inventor 2 自身 虽然 提供 了 许多 组 件 供 开 发 应 用 使 用 ， 但 这 些 组 件 或 多 或 少 存 
在 某 些 缺陷 或 功能 缺失 ， 使 用 不 是 很 方便 ， 在 开发 应 用 的 时 候 ， 无 论 是 应 用 的 UL 界面 ， 还 
是 功能 ， 都 很 受 限 制 ， 而 且 用 App Inventor 2 开发 应 用 还 需要 了 解 一 些 Android 相关 知识 ， 
这 些 书 籍 也 都 没有 涉及 。 

有 感 于 此 ， 编 者 编写 的 这 本 书 介绍 了 App Inventor 2 开发 涉及 的 Android 相关 知识 ，App 
Inventor 2 的 源码 、 自 带 组件 的 功能 扩展 和 插件 的 开发 ， 并 提供 了 大 量 实例 ， 使 读者 对 App 
Inventor 2 开发 相关 知识 有 一 个 全 面 了 解 ， 能 够 对 App Inventor 2 进行 定制 与 二 次 开发 ， 并 在 
此 基础 上 ， 能 够 以 更 专业 和 高 效 的 方式 开发 出 UI 界面 更 丰富 、 功 能 更 强大 的 应 用 。 

本 书 的 章节 分 为 以 下 几 部 分 。 

第 一 部 分 (第 1 FE): App Inventor 2 源码 的 获取 和 编译 。 


A — y 


第 二 部 分 (第 


第 三 部 分 (第 


] 的 注解 介 


6 章 ): App Inventor 2 ! 


2~5 章 ): Android 知识 介绍 alee Intent. Broadcast 和 权限 )。 
使 


秃 > 

EURI (AS 7~18 Æ): App Inventor 2 n a (Screen 的 定制 、 图 像 组 件 的 
定制 、 标 签 的 定制 、 列 表 显 示 框 的 定制 、 对 话 框 的 定制 、 输 入 框 的 共性 定制 、 密 码 输入 框 的 
定制 、 文 本 输入 框 的 定制 、Web 浏览 框 的 定制 、 音 频 播放 器 的 定制 、 视 频 播放 器 的 定制 、 画 
布 的 定制 、 文 件 管理 器 的 定制 、 微 数据 库 组 件 的 定制 和 Web 客户 端的 定制 )。 

第 五 部 分 (第 19 章 ):; 插件 的 开发 。 

第 六 部 分 (第 20 E): 综合 实例 开发 。 

由 于 编者 水 平 有 限 ， 编 号 过 程 中 难免 存在 不 足 和 缺陷 ， 欢 迎 广大 读者 和 专家 学 者 批评 指正 。 


编 者 


Ill 


前 言 

第 1 章 
1.1 
1.2 

第 2 章 
2.1 
2.2 


2.3 


2.4 


女生 = 


3 F 
3.1 
3.2 
3.3 
3.4 
3.5 
3.6 
第 4 章 
4.1 
4.2 


4.3 
第 5 章 
5.1 
5.2 
第 6 章 
6.1 


IV 


日 x 


App Inventor 2 源码 的 获取 和 编 谋 1 
SIE AEA He E Tralee Mera E E E E 1 
aE E 1 

Activity 介绍 dD ne a a oe de de i O 6 
创建 Activity ee 6 
P A 生生 全 玉生 再 7 
启动 Activity Se lve sagen ets e steep a N e a 
2.3.1 ”启动 Activity 不 获得 结果 … 人 nn 7 
2.3.2 ”启动 Activity 获得 结果 ee 8 
Activity 生命 周期 EEE EEOOESOOSOOESOOOSOOSEOOOSOOSOOOOSOOOSOOSOOOOOOOOSOOSOOOOOOOOSOOSOOOS 10 
24.1 ÆRA eee eeereereresererreresesesesereseseesenesesesnerereseeeeneneseseesesenesesesneneseseeene 10 
242 ”生命 周期 的 回调 函数 和 10 

Intent 介绍 和 13 
Intent 简介 和 13 
Intent 类 和 型 13 
构建 Intent EOE OESOOESOOSSO OSES ESSE OSSOOSSOOSOOOSSOOSSOOSOOOSOOOSSOOSOOOSSOOOSOOOSOSSS 14 
显 式 Intent 示例 ee 17 

隐 式 Intent 示例 sce teaeaetaeschats ae esate SA ae NN a Nese eet acetate had 17 
Intent 过 滤器 19 

Broadcast 介绍 eeeeeeeeeertererrertererteresrerteresteneesenteseteneerentesesteneesentenesseneesestesesseneesesteneeses 20 
Broadcast 机 制 概 述 a ea ed ev E tube ey a ye ee E Sue 20 
BroadcastReceiver er 20 

4.2.1 静态 注册 20 

po EAE Sf 交 sesde iE e aieo 生 abonda 21 
系统 广播 和 21 

权限 介绍 Se ee 23 
权限 简介 EOE OSES SESOSEOSSSOSOSOOSSOOOSOOOSOOOSOOOOOOOSOOOSOOOOOOOSOOOSOOOSOOSSOOOSOOOSOSS 23 
常用 权限 说 明 REESE ESO OESO CESS OSES OOOO OOOO OSES OOOO OSSOOSOOOOSOOSSOOSOOOSOOOSSOOOSOOOSOOOSOOOSOSSS 23 

注解 介绍 de 25 
DesignerComponent ee 25 


6.2 SimpleObject oo 27 


6.3 UsesPermissions pan 和 0 全 全 生生 二 as 27 
6.4 DesignerProperty ee 28 

6.5 SimpleProperty ee 29 

6.6 SimpleFunctiop ee 30 

6.7 SimpleEventee 30 
EGR 31 

6.9 RecelverElenent meie miiirn sess ua kakua a ENERE EREE KE DEN kS ENEN KE aain 32 

610  IntentFilterElement aa n errea eee eeteeeteeeseeeseenaeeneenseenseenseenaeenseenaeensecnseenseenaeenseenaeee 33 

6.11 ActionElement oA 33 

612 UsesLibraries :ccceccercereeeteeeeeeseeeseeeseenseensecnseenseenseenseenseenseensecnseenseensecnsecnaeensesnseenaeenneens 34 

第 7 = Screen 的 定制 0 35 
7.1 功能 菜单 的 修改 cerceeeeteeteeteeteetetteeteetseteeteeteenenteeteensententestsensenesteensenseneeneenseneeeensentens 35 

71.1 se =F asco ea rrrrerrrrererereererereseererereseseerereseseeneseneseseesenereseseeseneseseneeseneseee 35 

7.1.2 增加 设置 新 增 菜 单 的 属性 37 

7.1.3 新 增 菜 单 的 实现 coeeeeeeeeeeeeeeeeeeeessseceeeeeeeeestssnneeeeeetessssnneeeeeseetssseeeeeeesesettsseeeseceeeeeeeaes 38 

7.2 ”增加 和 暂停 和 恢复 状态 事件 响应 函数 vveeeeeeeeceeteeeeeeeeeeeeteeteeteenseteeteeeseseneeteeseesesteeneeneens 41 

第 8 章 像 组 件 (Image) 的 定制 a de 44 
8.1 PEEHI pio eee ae eee ee ener eee 44 

8.2 ”增加 设置 动画 播放 次 数 和 时 间 的 功能 eevveeeeeeeeseeseessessecssesscsscsscsncsnsssscnscescsncnnseseensensenass 47 

g3 BITE A NN Re eee ee ene eee see eee 5] 

第 9 章 示 签 (Label) 的 定制 Se 大 本 下 和 人 人 信息 区 5 芝 53 
ePaper Le ere ete 53 

9.2 ”增加 人 允许 被 选中 复制 的 属性 站 54 

g3 BIAS Sear EAE | NTC eee eee ee eee ee cere ene ne ere ere 54 

OMS Gn READ a Bue Hcp ee eee eR EOP ETT COE ECR Ee RT ne reser eer re 55 

AGS DIR ae Tea aes TSS ee cee ee eee creer eee eer eee eee 56 

9.6 TRADI FT SCAN ALB TH DR) Bales eeeceeeeeteeeeeeeeeseeeeeeseeseeseeeeenseesseesseenseesseesseesseesseesseesseeeseeeseeeseees 58 

9.7 ”实现 结果 63 

9.8 使 用 示例 64 

第 10 章 列表 显示 框 (Listview) 的 定制 a dd de tees 73 
ONE ETAN Aa a 73 

10.2 ”增加 显示 框 的 显示 样式 站 73 

第 11 章 对 话 框 (Notifier) 的 定制 TR A sees 77 
11.1 修改 对 话 框 的 外 观 77 
11.1.1 增加 设置 图 标的 属性 77 

11.1.2 ”增加 修改 对 话 框 显示 风格 的 属性 corceceeeeeeeeeeeeeeeeeeeeeeeeetteeeentteeeeestteeeeestneeeeseteeeeestaneeens 79 


11.2 
11.3 


12.1 


12.2 
12.3 
第 13 章 
13.1 
13.2 
13.3 
第 14 章 
14.1 


14.2 
第 1S 章 
15.1 
15.2 
15.3 
15.4 
15.5 
15.6 
第 16 章 
16.1 
16.2 
第 17 章 
17.1 
17.2 
17.3 
第 18 章 
18.1 
18.2 


VI 


NETAN E RR EEE OSOOSEOOSSOOSSOOSSOOOSOOOSOOSOOOOOOOSOOOOSOOSSOOOSOOSSOOS 82 
收 收 利 志 荔 外 NO 87 
11.3.1 日志 功 能 介绍 ERE DEO ETOOSEOTIOEOTEOSISOSEOEODSOEOLOSSOSOSISEOLISSOTOSESOLISEOLOCEOTOCEOSOTISESS 87 
11.3.2 SIAE RFPS Ba bere cece tee eeee cece ee ete te ere eeeeeenecssneerssenseseneessseeaseneeseneensseesaseneees 89 
aoe HER ee lathe yoke on nie ne Oren 92 
tay A AER Se ved f|| PEER ESSERE SESE OSES OESOESOSESSESSSESOOOSOSESOOOSOOOSOOOOOOOOOSSOOOOOOOOOOSSSOOOSOOSSOSEOOS 92 
12.1.1 增加 设置 字符 串 长 度 的 属性 和 核查 函数 站 92 
12.1.2 ”增加 清空 输入 框 的 函数 94 
密码 输入 框 (PasswordTextBox ) PRISE SI evceecceeceeceeeeeeeeseeceeeeneeeeeceeeseeneseneentecneenneensees 95 
文本 输入 框 (TextBox) 的 定制 a ee ate ee te ee ae 97 
Web 浏 览 框 (WebView) 的 定制 de ede re TE 99 
增加 拨号 功能 db ed dt dd nt dees essnocnte 99 
返回 键 功能 的 处 理 站 101 
DE A DE a IDAE 102 
播放 器 的 定制 和 105 
音频 播放 器 (Player) 的 定制 和 105 
TCG a D907 9° Ss ReaD EO DEERE TEOEETOREESODSORODESESIOSSISODEOROLICEOTONEOLOLEOLOLISEOTOCEOSODESLODICEOIOCESSODESEOTIOESS 105 
14.1.2 ”增加 获取 数据 函数 105 
14.1.3 ”增加 播放 函数 106 
视频 播放 器 (VideoPlayer ) 的 定制 和 107 
画布 (Canvas) 的 定制 en a se en ee nt de ee 108 
TRA TILT TEE] S| EE E 108 
PRATT ZS Hall EK FE DRIAL eee eeeeeeeteeeeseeenneeeneeeesteeenseeenseesseeesesenseseneeeeseeeeeeeenseseneeeeseneeennes 109 
增加 滑动 事件 响应 函数 和 111 
设置 函数 参数 的 默认 值 和 Ne 112 
增加 声明 和 中 文字 符 叶 0 113 
路 径 函 数 使 用 示例 站 0ee 117 
文件 管理 器 (File) 的 定制 TT ee ee ee oe 118 
增加 文件 处 理 画 数 和 0 118 
增加 获取 存储 区 信息 的 函数 cn eee eee eee teste eee eeee eee eeeeneeeneeeeseeneeeneeenseeeeesneesneeeneeeneeenes 120 
微 数 据 库 组 件 (TinyDB) 的 定制 Od 121 
存储 功能 介绍 121 
增加 设置 数据 文件 名 称 和 数据 加 密 功 能 站 122 
使 用 示例 a desu cubed valveres Ueveclve (eden tues ddesess costwedsseeuteedusccoves yp 127 
Web 客户 端的 定制 ee ed ne a 130 
增加 PATCH 请 求 函 数 和 130 
增加 设置 JSON 格式 数据 的 属性 ee 131 


第 19 章 插件 CExtemsiom) 开发 134 
19.1 加 密 功 能 播 件 ESOS OSSOOOEOOSSOOSEO OOOO OSSOOSOOOSSOOOOOOOSOOOOOOON 134 
19.1.1 插件 的 实现 习作 全 ee 134 
19.1.2 ”插件 的 编译 站 136 
19.1.3 ”插件 的 导入 nn 136 
19.1.4” 揪 件 的 使 用 aeRO ERE EO EEISO DEORE EEOEEIOSSISODSOROLSSEOTOCEOLODEOROLISEOTOCEOSODESSODICESIOCEISOSEOSODIOESS 137 

19.2 对话 框 搬 件 OSOOSOOSSOOEEOOSSOOSEOOSSOOOSOOSSOOSOOOOSOOOSOOOSOOO 137 
19.2.1 插件 的 实现 习作 放生 137 
19.2.2 ”插件 的 导入 138 

19.3 ”获取 设备 和 系统 信息 揪 件 Ne 139 
19.3.1 插件 的 实现 和 139 
19.3.2” 揪 件 的 使 用 改作 让 nes 142 

Oe AME es asc aac acc rach seh tat anc vara ts ae tats lan ha at 143 
19.4.1 插件 的 实现 EE OREO EEESOESORODESESTOSSSEODSOROLSCSIOSSOSODOEOLICESTOCOSODEOLODICEOTOCEOTOSEOEODISESS 143 
19.4.2 ”插件 的 使 用 改作 146 

19.$ 获取 和 监测 设备 网 络 状态 搬 件 Ne 147 
19.5.1 ”插件 的 实现 en 147 
19.5.2 ”插件 的 使 用 REE IEO TORO LEOELOSSISODSOROLISEOLOSSOLODEOROLSCESTOCEOSOSEOLODICESIOCEOSOSEOSODISESS 151 

19.6 ”获取 和 监测 设备 飞行 模式 状态 插件 wo eeeees ee eses ects ee tees nenenenenenenensseseseseseneneneneseneseesenenes 152 
19.6.1 插件 的 实现 站 153 
19.6.2” 揪 件 的 使 用 REEL EEEEOESORODEOSIOSSISODOROLISEOTOSSOLODOEOLESESIOCEOSOSESLODICESIOSEOSOSESEOTIOESS 155 

19.7 系统 设置 插件 和 155 
19.7.1 插件 的 实现 EE ERE LO EESODSOROIESESLOSSOSODOEOLSCESIONSOLODEOEOLECEOIOCEOSODEOSOLICEOIOCEOSODEOEODIOESS 155 
19.7.2 ”插件 的 使 用 RELIED ORO DEORE LOSS ILODSORODSSSTOCEESODEOEOLISEOTOCEOSODEOLODICEOIOCESSOSEOEODISESS 157 

1S eo Bac (s SRR ESSE OSSOSESOSSOOSSO OSES OSES OOOO OSOOOSOOOSSOOSOOOSSOOOSOOOSOOOSOOS 158 
19.8.1 ”列表 创建 158 
19.8.2 ”列表 排序 nn 159 
19.8.3 ae 9 eee EEO EEEOESORODESESIOSEISODEOROLSSESTOSOLODOEOLISESTOCEOSODEORODISEOTOCESSODESEOTISESS 160 
19.8.4 “插件 的 实现 和 161 
19.8.5 ”插件 的 使 用 REELED ORO EESEEIOOSILODSOROLSCESIOSSELODEOROLISESIOCEOSOSEOLODICEOIOCEOSOSEOEODISESS 164 

19.9 ”代数 计算 播 件 eee eteetensetseeeeteeenseneeneeensenseneeessenseneenessensenseneesessenseeens 165 
19.9.1 ”矩阵 的 运算 nn 165 
19.9.2 ”复数 的 运算 和 166 
19.9.3 02 F 8 |RSS EEESOESORODSSESLOOSOSODSOROLSSSOIOSEOSODEOEOLESESIOCEOSOSEOSODICEOIOCEOSOSEOSOTEOESS 167 
19.9.4” 揪 件 的 使 用 eR REESE EERO DESEELOSEOSODOROLSSESIOSSOSODIOROLISEOTOCEOSODEOLODISEOLOCEOSOSEOSOTIOESS 171 
19.10 ”几何 计算 插件 和 172 
19.10.1 TEER PREP eereeeeeeeeeeeeeeeeeeesteeeeeseeeeeessteeeesstteeeesseeeeestteeeeesteeeesseseeeeseseeensanees 172 


19,10.2 ”计算 图 形 的 体 秽 ， 和 0 172 

TODS CO SE £2 els hE 59 aeRO EE REO EESOESORODESSSIOSEOSODSSROLISEOLOSSOLODESEOLICEOTOCEISOSEOSOTSCESIOCESSOSEOSODIOESS 172 
19.11 手电 简 功 能 插件 和 175 
19.11.1 揪 件 的 实现 和 175 
19.11.2 ”插件 的 使 用 和 177 
19.12 手机 号 码 校 验 插 Pe rire EE Reh teed co td tt Sen sie he ahaa 178 
19.12.1 cs cat go ent) eee creo ree re ee re ree ee ree 178 
19.122 APRE eee eee ee en Soe eee eee ee eee ee 179 
19.13 ”判断 应 用 是 和 否 第 一 次 运行 插件 和 179 
19.13.1 “ 播 件 的 实现 习作 ee 180 
19.13.2 HERJE = Re Rae ERE EO EEROEEEEE LOSS ILOSSORODICESTOSEISODEOEOLESEOIOCEESODEOROTICEOIOCEOSOSSSSODISESS 182 
19.14 ”获取 定位 功能 状态 播 件 站 182 
19.14.1 “ 播 件 的 实现 和 182 
19.14.2” 播 件 的 使 用 改作 和 ee 184 
19.15 创建 JSON FRB eeereereerererererreresesererereseeenenesesesneneneseenneneseseeneneseseeersenes 184 
19.15.1 “ 播 件 的 实现 习作 es 184 
190.159 捕 件 的 使 用 oo 187 

第 20 章 BAPAE EEE 189 
20.1. PAFRPIENPIR RRR EEE SESSOSESSSSSSOSSOSOSSOSSOSSOOOSEOOSOSSOSSOOOSSOSOOOSOSOOSOOSOOSOSSS 189 
20.1.1 游戏 简介 .ee 189 
20.1.2 ”游戏 使 用 的 素材 ceeeeeceeeeeeeeeeeeeeeeeeteeeettseeeestteeeeestteeeestseeeesteneeenstneeeessseeeeeseaeeeeeeanees 189 
20.1.3 ”游戏 使 用 的 插件 …… 于 nn 189 
20.1.4 ”游戏 实现 和 190 
20.2 ” 国 图 应 用 eS 203 
OXY a GS $= 111d Re RE REEL IEO ESSE TEOEETOOEESODESEOIESSSIOCEOSODOEODISETIOSEISOLISEOTISSIOSEOLODIORODISESS 203 
20.2.2 ”应 用 使 用 的 素材 seeeseeeeceee eee tense ten eseteeeseneetenecssteeesenseseneesseeesssenssseneessseessseeseseneees 204 

OX Wy Me MAS 02 1-03 72 2 PREECE EOC EEO DEERE IEOELIOOSISODEOROLICESTOSEOSODEOEODSSEOSOSETIODEOSOTISEES 204 
20.2.4 应 用 实现 和 ee 204 
20.3 ”定位 应 用 … 225 
OX Wa GS ¢= 117s RRL ERTL EEOEO DEORE EEOEEEOOEESODSSEOIEOSIIOCSOSODIOEODOCESTOCEISOLISEOTISEOLOSESLODEOEOTISESS 225 
20.3.2 ”应 用 使 用 的 素材 eeeeeeereeereteserrerereseeeerereseseesereseseeeeneneseseeneneseseeeesereseseeneneneseneese 226 
20.3.3 ”应 用 使 用 的 插件 站 人 nen 226 
20.3.4 ”应 用 实现 和 ee 227 


VHI 


第 1 六 App Inventor 2 源码 的 获取 和 编译 


1.1 源码 的 获取 


从 GitHub 网 站 上 可 以 获取 到 App Inventor 2 的 源码 ， 网 址 如 下 : https://github.com/mit- 
cml/ appinventor-sources 。 


在 计算 机 上 安装 git 后 ， 使 用 以 下 命令 从 GitHub 服务 器 上 复制 代码 : 


git clone https://github.com/mit-cml/appinventor-sources.git 


App Inventor 2 源码 还 使 用 了 git submodule 机 制 ， 执 行 完 git clone 命令 后 ， 进 入 到 源码 
的 根 目 录 /appinventor， 然 后 执行 : 


git submodule update --init 


这 样 才能 获得 全 部 代码 。 


1.2 源码 的 编译 


App Inventor 2 的 编译 工具 是 ant， 计 算 机 上 需要 有 ant 工具 ， 并 配置 ant 的 环境 变量 ， 
在 MAC 电脑 上 显示 如 下 : 


export ANT HOME=/Users/ruwang/Downloads/apache-ant-1.10.1 
export PATH=$ {PATH}:${ANT HOME}/bin 


在 App Inventor 2 的 GitHub 网 页 上 ， 有 如 下 说 明 : 


You will need a full Java JDK (6 or 7, preferably from Oracle; JRE is not enough) and Python to compile 
and run the servers. 


需要 在 计算 机 上 安装 JDK6 或 JDK7， 才 能 正常 编译 。 
但 ant 的 版 本 不 同 ， 需 要 的 IDK 也 不 同 ， 如 1.10.1 版 本 就 需要 JDK8， 否 则 纲 译 的 时 
候 ， 会 报 如 下 错误 : 


Exception in thread "main" java.lang.UnsupportedClassVersionError: org/apache/tools/ant/launch/ 


Launcher: Unsupported major.minor version 52.0 


编译 的 时 候 ， 在 App Inventor 2 源码 的 根 目录 /appinventor 下 ， 直 接 输 入 ant 命令 ， 会 编 


~ 


译 所 有 源码 ， 花 费时 间 较 长 ， 实 际 往往 不 需要 编译 全 部 代码 ， 只 编译 改动 的 模块 就 可 以 了 。 
在 源码 的 根 目 录 /appinventor 下 有 个 build.xml 文件 ， 在 其 中 有 许多 target 标签 : 


Ti. 


<target name="all"> 
<ant inheritAll="false" useNativeBasedir="true" dir="appengine"/> 
<ant inheritAll="false" useNativeBasedir="true" dir="blocklyeditor"/> 
<ant inheritAll="false" useNativeBasedir="true" dir="common"/> 
<ant inheritAll="false" useNativeBasedir="true" dir="buildserver"/> 
<ant inheritAll="false" useNativeBasedir="true" dir="components"/> 
<ant inheritAll="false" useNativeBasedir="true" dir="buildserver" target="PlayApp"/> 


</target> 
<target name="MakeAuthKey"> 


<target name="comps"> 


<target name="extensions"> 


<target name="clean"> 


<ant inheritAll="false" useNativeBasedir="true" dir="appengine" target="clean"/> 
<ant inheritAll="false" useNativeBasedir="true" dir="blocklyeditor" target="clean"/> 
<ant inheritAll="false" useNativeBasedir="true" dir="aimerger" target="clean"/> 
<ant inheritAll="false" useNativeBasedir="true" dir="buildserver" target="clean"/> 
<ant inheritAll="false" useNativeBasedir="true" dir="common" target="clean"/> 
<ant inheritAll="false" useNativeBasedir="true" dir="components" target="clean"/> 
<delete dir="build"/> 

<delete dir="reports"/> 


</target> 


每 个 target 标签 中 间 说 明了 使 用 ant + target name 时 编译 的 模块 ， 如 输入 如 下 命令 : 
编译 所 有 模块 ， 等 同 于 只 输入 ant; 

ant extensions 一 一 编译 插件 ; 

ant MakeAuthKey 编译 AuthKey。 

还 有 个 特殊 的 编译 命令 : 

ant clean 删除 之 前 编译 生成 的 build 和 reports 文件 夹 。 

需要 先 使 用 ant MakeAuthKey 命令 生成 AuthKey 后 ， 才 能 使 用 其 他 命令 编译 。 

使 用 ant 命令 编译 后 ， 还 不 能 在 本 机 运行 App Inventor 2 的 开发 环境 ， 计 算 机 上 还 需 有 
appengine-java-sdk， 同 时 也 要 配置 环境 变量 : 


ant all 
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地 


export PATH=$PATH:/Users/ruwang/Downloads/appengine-java-sdk- 1 .9.54/appengine-java-sdk-1.9.54/bin/ 
在 源码 的 根 目录 /appinventor 下 ， 运 行 如 下 命令 : 


/Users/ruwang/Downloads/appengine-java-sdk-1.9.54/bin/dev_appserver.sh --port=8888 --address= 0.0.0.0 


appengine/build/war/ 


当 命令 行 窗 
运行 成 功 ， 如 


而 


1-1 所 示 。 


elo <clinit> 
信息 : Default GCS Bucket Configured from App Identity: app_default_bucket 
十 月 17, 2017 1:55:58 EL 4 com.google.appengine.api.datastore.dev.LocalDatastore 
Service init 
信息 : Local Datastore initialized: 

Type: High Replication 

Storage: /Users/ruwang/Documents/code/learn/appinventor/appinventor-sour 
ces/appinventor-sources/appinventor/appengine/build/war/WEB-INF/appengine-genera 
ted/local_db.bin 
+A 17, 2017 1:55:58 £4 com.google.appengine.api.datastore.dev.LocalDatastore 
Service load 
信息 : Time to load datastore: 62 ms 
十 月 17, 2017 1:55:58 £4 com.google.apphosting.utils.jetty.JettyLogger info 
信息 : Started SelectChannelConnector@0.0.0.0:8888 
+A 17, 2017 1:55:58 E 4 com.google.appengine.tools.development.AbstractModule 
startup 
信息 : Module instance default is running at http://localhost:8888/ 
+A 17, 2017 1:55:58 £4 com.google.appengine. tools.development.AbstractModule 
startup 
信息 : The admin console is running at http://localhost:8888/_ah/admin 
+A 17, 2017 9:55:58 上 午 com.google.appengine.tools.development.DevAppServerIm 
pl doStart 
信息 : Dev App Server is now running 


图 1-1 dev_appserver.sh 命令 运行 结果 


然后 在 源码 的 /appinventor/buildserver 目录 下 ， 运 行 如 下 命令 : 


当 命令 行 窗口 显示 “[java] 信息 : Server running” 这 行 字 符 串 时 ， 表 示 此 


功 ， 如 


ant RunLocalBuildServer 


图 1 


-2 PAN. 


Server main 

[java] 信息 : App Inventor Build Server - Version: nls-1064-g3274ac6-dirty 

[java] +A 17, 2017 10:08:03 上 午 com.google.appinventor. buildserver.Build 
Server main 

[java] 信息 : App Inventor Build Server - Git Fingerprint: 3274ac6e091c275ce 
921fea4673dfae6b73c1b44 

[java] +A 17, 2017 10:08:03 上 午 com.google.appinventor. buildserver. Build 
Server main 

[java] 信息 : Running at: http://10.0.34.123:9990/buildserver 

[java] +A 17, 2017 10:08:03 上 午 com.google.appinventor.buildserver.Build 
Server main 

[java] 信息 : Maximum simultanous builds = unlimited! 

[java] +A 17, 2017 10:08:03 上 午 com.google.appinventor. buildserver. Build 
Server main 

[java] 信息 : Visit: http://10.0.34.123:9990/buildserver/health for server h 
ealth 

[java] +A 17, 2017 10:08:03 上 午 com.google.appinventor. buildserver.Build 
Server main 

[java] 信息 : Visit: http://10.0.34.123:9990/buildserver/vars for server val 
ues 

[java] +A 17, 2017 10:08:03 L 4 com.google.appinventor.buildserver.Build 
Server main 

[java] 信息 : Server running 


图 1-2 RunLocalBuildServer 命令 运行 结果 


个 人 
命令 


i 


we 


显示 “信息 : Dev App Server is now running” 这 行 字符 串 时 ， 表 示 此 命令 


行 成 


如 


在 浏览 器 的 地 址 栏 中 ， 输 入 如 下 地 址 : http:Wlocalhost:8888， 按 回 车 键 后 ， 显 示 内 


1-3 所 示 。 


Welcome to App Inventor! 


Email 


Password 
Login 
Set or Recover Password 
Click Here to use your Google Account to login 
中 文 English 
| 


图 1-3 App Inventor 2 欢迎 界 国 


系统 语言 默认 是 英文 ， 可 以 单 击 中 文 按 钮 ， 将 系统 语言 切换 为 中 文 。 


单 击 图 1-4 所 示 登 录 文字 标签 ， 将 显示 图 1-5 所 示 的 登录 界面。 


Click Here to use your Google Account to login 


图 1-4 ”登录 文字 标签 


Not logged in 


Email: test@example.com 


Sign in as Administrator 


Log In Log Out 


图 1-5 ”登录 界面 


单 击 “Log Im” 按钮 ， 显 示 图 1-6 所 示 服 务 条 球 界 面 。 


To use App Inventor for Android, you 
must accept the following terms of 
Service. 


Terms of Service 


You agree to have lots of fun learning to 
use App Inventor and making apps for 
your Android device! 


| accept the terms of service! 


图 1-6 服务 条 球 界 下 


fitz “I accept the terms of service!” 按 钮 就 可 以 进入 开发 环境 ， 开 始 App Inventor 2 的 编 
程 之 旅 了 。 

App Inventor 2 是 基于 Android 系统 衍生 的 一 个 系统 ， 无 论 是 使 用 App Inventor 2 开发 应 
用 ， 还 是 对 App Inventor 2 进行 二 次 开发 ， 都 要 用 到 许多 Android 开发 的 相关 知识 ， 下 面 介 
绍 Activity、Intent 和 权限 等 相关 知识 。 


片 、 发 送 电子 

每 个 Activity 都 有 一 个 用 于 
浮动 在 其 他 窗口 之 上 。 
散 联 系 的 Activity 组 成 。 一 般 会 指定 应 用 
用 户 的 那个 Activity。 而 且 每 个 Activity 均 可 启 


小 于 屏幕 3 
一 个 应 
为 “ 主 ”Activity， 即 首次 启动 应 用 时 呈现 给 
动 男 一 个 Activity， 以 便 执行 不 同 的 操作 。 
在 App Inventor 2 中 ， 一 个 Screen 就 对 应 一 个 Activity。Screen 的 源码 文 伯 


其 


第 2 章 Activity 介绍 


yale 


H 


PP 有 以 下 代码 ; 


多 个 彼此 松 


Activity 是 一 个 应 用 组 件 ， 用 户 可 与 其 提供 的 屏 
g 件 或 查看 地 图 等 各 种 操作 。 
绘制 此 Activity 界面 的 窗口 。 


Th 


public class Form extends Activity 


幕 进行 交互 ， 执 行 拨打 


Eim HE 


NL 


3 


implements Component, ComponentContainer, HandlesEventDispatching, 


OnGlobalLayoutListener { 


} 


2.1 tI Activity 


Activity. (1 
两 个 最 重要 的 函 


@onCreate() 


此 函数 必须 实现 。 系 统 会 在 创建 Activity 时 调用 此 函数 。 在 
Activity 的 必需 组 件 。 


@onPause() 


系统 将 此 函数 作为 用 户 离 


数 是 : 


创建 Activity 时 ， 要 实现 Activity 在 其 9 
E Activity, kd Activity 或 销毁 Activity) 时 系统 调 月 


Activity 的 第 一 个 信号 (但 并 不 总 是 意味 着 Activity 会 被 销 


Form 类 是 Activity 的 子 类 ， 所 以 Screen 就 对 应 着 Activity。 


E 命 周期 的 各 种 状态 之 间 转 变 〈 例 如 ， 创 建 
日 的 函数 。 


通常 会 充满 屏幕 ， 但 也 可 


Pp 的 菜 个 Activity 


为 Form.java, 


， 应 初始 化 


BO) 进行 调用 。 通 常 在 此 函数 内 应 确认 厂 
户 可 能 不 会 返回 )。 


E 当 前 用 户 会 话 结束 后 仍然 有 


效 的 任何 更 改 C 


因为 用 


2.2 ”用户 界面 的 实现 


Activity 的 用 户 界面 是 由 层级 式 视图 (衍生 自 View 类 的 对 象 ) 提 供 的 。 每 个 视图 都 控制 
Activity 窗口 内 的 特定 矩形 空间 ， 可 对 用 户 交 互 做 出 响应 。 例 如 ， 视 图 可 以 是 在 用 户 触摸 时 
启动 某 项 操作 的 按钮 。 

可 以 利用 Android 提供 的 许多 现成 视图 设计 和 组 织 布局 “小 部 件 ” 是 提供 按钮 、 文 本 
字段 、 复 选 框 或 仅仅 是 一 幅 图 像 等 屏幕 视觉 peat 元 素 的 视图 .。“ 布 局 ”是 衍生 
A ViewGroup 类 的 视图 ， 为 其 子 视图 提供 唯一 布局 模型 ， 如 线性 布局 、 网 格 布局 或 相对 布 
局 等 。 


还 可 以 为 View 类 和 ViewGroup 类 创建 子 类 《或 使 用 其 现 有 子 类 ) 来 自行 创建 小 部 件 和 
布局 ， 然 后 将 它们 应 用 于 Activity 布局 。 

视图 定义 布局 的 最 常见 方法 是 借助 保存 在 应 用 资源 内 的 XML 布局 文件 。 这 样 ， 就 可 以 
将 用 户 界 面 的 设计 与 定义 Activity 行为 的 源 代 码 分 开 维 护 。 

可 以 通过 setContentView() 将 布局 设置 为 Activity 的 UI， 从 而 传递 布局 的 资源 ID. thay 
以 在 Activity 代码 中 创建 新 View， 并 通过 将 新 View 插入 ViewGroup 来 创建 视图 层次 ， 然 后 
通过 将 根 ViewGroup 传递 到 setContentView() 来 使 用 该 布局 。 


2.3 JAZ) Activity 


可 以 通过 调用 startActivity()), JF 
个 Activity。 

Intent 对 象 指定 想 启 动 的 具体 Activity 或 描述 想 执 行 的 操作 类 型 (系统 会 选择 合适 的 
Activity， 甚 至 是 来 自 其 他 应 用 的 Activity). Intent 对 象 还 可 能 携 Ay > BI JAB Activity 使 
用 的 数据 。 


2.3.1 ”启动 Activity 不 获得 结果 


在 应 用 运行 时 ， 经 常 需要 启动 某 个 已 知 Activity。 可 以 通过 使 用 类 名 创建 一 个 显 式 定义 
想 启 动 的 Activity 的 Intent 对 象 来 实现 此 目的 。 
例如 ， 可 以 通过 以 下 代码 让 一 个 Activity 启动 男 一 个 名 为 LogInActivity 的 Activity: 


~ 


各 其 传递 给 描述 想 启 动 的 Activity 的 Intent 来 启动 另 一 


ei 


Intent intent = new Intent(this, LogInActivity.class); 
startA ctivity (intent); 


应 用 可 能 还 需要 利用 Activity 数据 执行 某 项 操作 ， 如 打 电 话 、 打 开 网 页 或 发 短信 等 。 在 
这 种 情况 下 ， 应 用 自身 可 能 不 具有 执行 此 类 操作 所 需 的 Activity， 因 此 可 以 改 为 利用 设备 上 
其 他 应 用 提供 的 Activity 来 执行 这 些 操作 。 这 便 是 Intent 对 象 的 真正 价值 所 在 。 
开发 人 员 可 以 创建 一 个 Intent 对 象 ， 对 想 执行 的 操作 进行 描述 ， 系 统 会 从 其 他 应 用 启动 
相应 的 Activity。 如 果 有 多 个 应 用 可 以 处 理 Intent， 则 用 户 可 以 选择 要 使 用 哪 一 个 。 


在 App Inventor 2 的 电话 拨号 器 组 件 的 源码 文件 PhoneCallUtiljava 中 ， 有 如 下 代码 : 


public static void makePhoneCall(Context context, String phoneNumber) { 
if (null != phoneNumber && phoneNumber.length() > 0) { 
Uri phoneUri = Uri.parse("tel:" + phoneNumber); 
Intent intent = new Intent(Intent. ACTION CALL, phoneUri); 
context.startA ctivity (intent); 


} 

此 函数 用 于 调用 设备 上 的 拨打 电话 应 用 ， 当 拨打 电话 应 用 响应 此 Intent 时 ， 会 读 取 
Intent 函数 第 二 个 参数 设置 的 电话 号 码 拨打 电话 ， 并 且 当 用 户 完成 操作 ， 退 出 拨打 电话 应 用 
后 ， 之 前 应 用 的 Activity 会 恢复 执行 。 

2.3.2 ”启动 Activity 获得 结 

有 时 ， 可 能 需要 从 启动 的 Activity 获得 结果 ， 也 就 是 A 启动 B，B 再 返回 数据 给 A。 在 
这 种 情况 下 ， 通 过 调用 startActivityForResult()〔 而 非 startActivity()) 来 启动 Activity。 要 想 在 
A 中 收 到 B 返回 的 数据 ， 需 要 实现 onActivityResult0 函 数 。 在 B Activity 中 ， 使 用 Intent 向 
onActivityResult() K Aci [A] AG 

在 App Inventor 2 的 条 码 扫 描 器 组 件 的 源码 文件 BarcodeScanner.java 中 ， 有 如 下 
代码 : 


@SimpleFunction(description = "Begins a barcode scan, using the camera. When the Scan " + 
"is complete, the AfterScan event will be raised.") 
public void DoScan() { 
Intent intent = new Intent(SCAN_INTENT); 
if (tuseExternalScanner && (SdkLevel.getLevel() >= SdkLevel. LEVEL ECLAIR)) { 
// Should we attempt to use an internal scanner? 
String packageName = container.$form().getPackageName(); 
intent.setComponent(new ComponentName(packageName, "com.google.zxing.client.android. 
AppInvCaptureActivity")); 
j 
if (requestCode == 0) { 
requestCode = form.registerForActivityResult(this); 
} 
try { 


container.$context().startActivityForResult(intent, requestCode); 
} catch (ActivityNotFoundException e) { 
e.printStackTrace(); 
container.$form().dispatchErrorOccurredEvent(this, "BarcodeScanner", 
ErrorMessages.ERROR_NO SCANNER FOUND, ""); 


@Override 
public void resultReturned(int requestCode, int resultCode, Intent data) { 
if (requestCode == this.requestCode && resultCode == Activity. RESULT_OK) { 
if (data. hasExtra'SCANNER RESULT NAME)) { 
result = data.getStringExtra( SCANNER RESULT NAME); 
} else { 
result = ""; 


} 


AfterScan(result); 


} 


在 App Inventor 2 中 的 Form.java 文件 中 有 如 下 代码 : 


@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
Log.i(LOG_TAG, "Form "+ formName + " got onActivityResult, requestCode = " + 
requestCode + ", resultCode =" + resultCode); 
if (requestCode == SWITCH FORM REQUEST CODE) { 
// Assume this is a multiple screen application, and a secondary 
// screen has closed. Process the result as a JSON-encoded string. 
// This can also happen if the user presses the back button, in which case 
// there's no data. 
String resultString; 
if (data != null && data.hasExtra(RESULT_NAME)) { 
resultString = data. getStringExtra(RESULT_NAME); 
} else { 
resultString = ""; 
} 
Object decodedResult = decodeJSONStringForForm(resultString, "other screen closed"); 
// nextFormName was set when this screen opened the secondary screen 
OtherScreenClosed(nextFormName, decodedResult); 
} else { 
// Another component (such as a ListPicker, ActivityStarter, etc) is expecting this result. 
ActivityResultListener component = activityResultMap.get(requestCode); 
if (component != null) { 


component.resultReturned(requestCode, resultCode, data); 


使 用 扫描 功能 时 ， 在 BarcodeScanner 类 的 DoScan0 函 数 中 调用 startActivityForResult() 
函数 启动 扫描 Activity， 扫 描 完 成 后 ， 把 得 到 的 数据 传递 给 Form 类 的 onActivityResult() 
函数 ， 最 终 调用 BarcodeScanner 类 的 resultReturned() efi 2 Ah HE FA fi BCH. (Screen 对 应 
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Activity， 条 人 码 扫描 器 组 件 附着 在 Screen 上 ， 所 以 把 数据 传递 给 Form 类 的 onActivityResult() 
函数 )。 

在 resultReturned() 函数 中 ， 首 先 检查 请 求 是 否 成 功 〈 如 果 成 功 ， 则 resultCode 将 为 
RESULT OK)， 以 及 是 否 是 指定 请 求 返回 的 数据 ， 也 就 是 将 requestCode 与 startActivityForResult() 
函数 发 送 的 第 二 个 参数 匹配 。 只 有 请 求 成 功 ， 且 requestCode 匹配 成 功 后 ， 才 处 理 data 参数 
返回 的 数据 。 

可 以 通过 调用 Activity 的 finish KARA RA Activity， 还 可 以 通过 调用 finishActivity() 
函数 结束 当前 之 前 启动 的 另 一 个 Activity。 

在 大 多 数 情况 下 ， 不 应 使 用 这 些 方法 显 式 结束 Activity. Android 系统 会 管理 Activity 的 
生命 周期 ， 因 此 无 须 开 发 人 员 编 写 代码 结束 Activity。 调 用 这 些 函数 可 能 对 预期 的 用 户 体 验 
产生 不 良 影 响 ， 因 此 只 应 在 确实 不 想 让 用 户 返 回 此 Activity 实例 时 ， 才 编写 代码 结束 
Activity， 而 不 依赖 系统 结束 Activity。 


2.4 Activity 生命 周期 


2.4.1 生命 周期 的 状态 


Activity 基本 上 以 三 种 状态 存在 。 

1. 继续 

此 种 状态 的 Activity 位 于 屏幕 前 台 并 具有 用 户 焦点 ， 可 响应 用 户 操作 《〈 也 将 此 状态 
称 作 “运行 中 ”)。 

2. 暂停 
有 一 个 部 分 透明 或 未 覆盖 整个 屏幕 的 Activity 显示 在 另 一 个 Activity 上 方 ， 位 于 屏幕 
前 合并 具有 用 户 焦 点 ， 响 应 用 户 操 作 ， 此 时 位 于 下 方 的 Activity 仍 可 见 ， 所 处 的 状态 就 是 
暂停 状态 。 和 暂停 的 Activity 处 于 完全 活动 状态 (Activity 对 象 保留 在 内 存 中 ， 它 保留 了 所 有 
状态 和 成 员 信息 ， 并 与 窗口 管理 器 保持 连接 )， 但 在 内 存 极度 不 足 的 情况 下 ， 可 能 会 被 系统 
终止 
3. 停止 
此 种 状态 的 Activity 被 另 一 个 Activity 完全 遮盖 (该 Activity 目前 位 于 “后 台 ”)。 已 停 
止 的 Activity 同样 仍 处 于 活动 状态 (Activity 对 象 保留 在 内 存 中 ， 它 保留 了 所 有 状态 和 成 员 
信息 ， 但 未 与 窗口 管理 器 连接 )。 不 过 ， 它 对 用 户 不 再 可 见 ， 在 他 处 需要 内 存 时 可 能 会 被 系 
统 终止 。 
WER Activity 处 于 暂停 或 停止 状态 ， 系 统 会 通过 调用 finish() 函数 结束 此 Acticity 或 直接 
终止 其 进程 ， 并 将 其 从 内 存 中 删除 。 
将 其 结束 或 终止 后 ， 再 次 打开 Activity 时 ， 必 须 调用 onCreate() 函 数 重建 。 


2.4.2 ”生命 周期 的 回调 函数 


Activity 生命 周期 如 图 2-1 所 示 。 
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启动 Activity 


OnCteate() 
OnStart() 


OnRestart() 


App 进 程 被 杀 死 


Activity 处 于 
运行 状态 

全 > 另 一 个 Activity | ”用 户 返 回 到 | 
来 到 前 台 运 行 


ES 当前 Activity | 
不 再 可 见 


Activity EMEA | 
被 系统 销毁 中 


OnDestory() 


Activity 结 束 运行 


图 2-1 Activity 生命 周期 


表 2-1 列 出 了 生命 周期 回调 函数 ， 其 中 对 每 一 个 回调 函数 做 了 更 详细 的 描述 ， 并 说 明了 
每 一 个 函数 在 Activity 整个 生命 周期 内 的 位 置 ， 包 括 在 回调 函数 完成 后 系统 能 否 终止 
Activity。 


让 


ua 


#2 2-1 Activity 生命 周期 回调 函数 


AS fats oe 
函数 说 明 ee pe 
创建 Activity 时 调用 。 应 该 在 此 函数 中 执行 所 有 正常 的 静 
onCreateO 态 设置 一 一 创建 视图 、 将 数据 绑 定 到 列表 等 。 系 统 向 此 函数 7 onStart() 
传递 一 个 Bundle WR, HPA Activity 的 上 一 状态 ， 不 过 
前 提 是 捕获 了 该 状态 。 始 终 接 onStart() 
Activity 已 停止 并 即将 再 次 启动 前 调 
aike a : oe 将 再 次 启动 前 调 7 onStart() 
在 Activity 即将 对 用 户 可 见 之 前 调用 。 如 果 Activity HA N 或 
onStart() 前 台 ， 则 后 接 onResume0， 如 果 Activity 转 入 隐藏 状态 ， 则 | F eet es 
后 接 onStop() p 
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X 


函数 说 明 后 接 
在 Activity 即将 开始 与 用 户 进 行 交 互 之 前 调用 。 此 时 ， 
onResume() Activity 处 于 Activity 堆栈 的 顶层 ， 并 有 具有 用 户 输入 焦点 。 onPause() 
始终 后 接 onPause() 
当 系 统 即 将 开始 继续 另 一 个 Activity 时 调用 。 此 函数 通常 
于 确认 对 持久 性 数据 的 未 保存 更 改 、 停 止 动画 以 及 其 
onPause() 能 消耗 CPU 的 内 容 ， 诸 如 此 类 。 它 应 该 非常 迅速 地 = onResume0) 或 
需 操作 ， 因 为 它 返回 后 ， 下 一 个 Activity 才能 继续 执行 = onStop() 
果 Activity 返回 前 台 ， 则 后 接 onResume()， 如 果 Activity 转 
入 对 用 户 不 可 见 状态 ， 则 后 接 onStop() 
在 Activity 对 用 户 不 再 可 见 时 调用 。 如 果 Activity 被 销毁 ， 
或 另 一 个 Activity (一 个 现 有 Activity 或 新 Activity) 继续 执 onRestart() 
onStop() 行 并 将 其 覆盖 ， 就 可 能 发 生 这 种 情况 。 或 
如 果 Activity 恢复 与 用 户 的 交互 ， 则 后 接 onRestart(), WR onDestroy() 
Activity 被 销毁 ， 则 后 接 onDestroy() 
在 Activity 被 销毁 前 调用 。 这 是 Activity 收 到 的 
onDestroyO 。 当 Activity 结束 (对 Activity 调用 了 finish), RRRA 是 无 


名 为 “是 否 能 事后 


省 空间 而 暂时 销毁 该 Activity 实例 时 ， 可 能 会 调 


六 通过 isFinishing() 函数 区 分 这 两 种 情形 


方法 返回 后 终止 承载 Activity 的 进程 。 


数 ， 然 后 才能 终止 进程 ; 
onDestroy()。 因 此 ， 应 该 使 月 
户 编辑 或 输入 的 数据 等 )。 不 


h 


方法 的 执行 时 间 过 长 ， 会 妨碍 向 下 一 个 Activity 的 转变 并 且 用 户 感觉 3 
在 “是 否 能 在 F?” 列 中 标记 为 “ 否 ” 的 函数 可 从 系统 调 


aX Activity 的 进程 被 终 1 


Ha Il 


在 onPause() 执行 完毕 至 


onPause() 被 再 次 调 


根据 上 述 内 容 上 
情况 只 有 在 无 任何 其 他 资 
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FRITH 


ai 


I 


有 三 个 函数 带 有 “是 ”标记 : (onPause()、onStop() 和 onDestroy()). 
于 onPause() 是 这 三 个 函数 中 的 第 一 个 ， 因 此 Activity 创建 后 ， 需 要 调 月 


上 果 系 统 在 紧急 情况 下 必须 恢复 内 存 ， 则 可 能 
H onPause() 回 存 储 设备 写 入 至 关 习 
过 ， 应 对 onPause() 调用 期 间 必 须 保留 的 信息 有 所 选择 ， 如 果 该 


终止 ?” 的 列表 示 系 统 是 否 能 在 不 执行 其 他 Activity 代码 的 情况 下 ， 在 


H onPause() eI 
\ 会 调用 onStop0 和 
EE 要 的 持久 性 数据 (例如 ， 用 


运行 速度 变 慢 。 
它们 的 一 刻 起 防止 承 


| onResume() 被 调用 的 这 段 时 间 内 ， 系 统 可 以 终止 Activity。 在 
1， 将 无 法 再 次 终 上 Activity. 
述 ， 属 于 技术 上 无 法 “终止 ”的 Activity 仍 可 能 被 系统 终止 ， 但 这 种 
源 的 极端 情况 下 才 会 发 生 。 


337% Intent 介绍 


3.1 Intent 简介 


Intent 是 一 个 消息 传递 对 象 ， 可 以 使 用 它 向 其 他 应 用 组 件 请 求 操作 。 尽 管 Intent 可 以 通 
过 多 种 方式 促进 组 件 之 间 的 通信 ， 但 其 基本 用 例 主要 包括 以 下 三 种 。 
1. 启动 Activity 
通过 将 Intent 传递 给 startActivity0， 可 以 启动 新 的 Activity 实例 。Intent 描述 了 要 启动 的 
Activity， 并 携带 了 任何 必要 的 数据 。 
如 果 希 望 在 Activity 运行 完成 后 收 到 结果 ， 需 要 调用 startActivityForResult0。 在 Activity 
的 onActivityResult() 回调 中 ，Activity 将 结果 作为 单独 的 Intent 对 象 接收 。 
2. 启动 服务 
Service 是 一 个 没有 用 户 界 面 而 在 后 侣 执行 操作 的 组 件 。 通 过 将 Intent 传递 给 
startService()， 可 以 启动 服务 执行 操作 (例如 ， 下 载 文 件 )。Intent 描述 了 要 启动 的 服务 ， 并 
携带 了 任何 必要 的 数据 。 
3. 传递 广播 
广播 是 任何 应 用 均 可 接收 的 消息 。 系 统 将 针对 系统 事件 (例如 ， 系 统 启动 或 设备 开始 充 
时) 传递 各 种 广播 。 通 过 将 Intent 传递 给 sendBroadcast()、sendOrderedBroadcast() 或 
sendStickyBroadcast0)， 可 以 将 广播 传递 给 其 他 应 用 。 


3.2 Intent 类 型 


1. 显 式 Intent 
WI Intent 按 名 称 〈 完 全 限定 类 名 ) 指定 要 启动 的 组 件 。 通 常 ， 开 发 人 员 会 在 自己 开发 
的 应 用 中 使 用 显 式 Intent 来 启动 组 件 ， 这 是 因为 开发 人 员 知 道 要 启动 的 Activity 或 服务 的 类 
名 。 例 如 ， 启 动 新 Activity 以 响应 用 户 操作 ， 或 者 启动 服务 以 在 后 台 下 载 文件 。 

创建 显 式 Intent 启动 Activity 或 服务 时 ， 系 统 将 立即 启动 Intent 对 象 中 指定 的 应 用 
组 件 。 

2. Baxt Intent 

Kast Intent 不 指定 特定 的 组 件 ， 而 是 声明 要 执行 的 常规 操作 ， 从 而 允许 其 他 应 用 中 的 组 
件 来 处 理 它 。 例 如 ， 如 需 打 开 网 页 ， 则 可 以 使 用 隐 式 Intent， 请 求 另 一 具有 此 功能 的 应 用 打 
指定 的 网 页 。 

3-1 描述 了 隐 式 Intent 如 何 通 过 系统 传递 以 启动 其 他 Activity. 


13 


pan Intent -- 
1 
1 


startActivity() 
1 


1) Activity A 创建 包含 操作 


2) Android 系统 搜索 所 有 应 用 
到 匹配 项 之 后 ， 系 统 通 
传递 给 Intent， 以 此 启动 匹配 Activity. 

创建 隐 式 Intent IN, Android 系统 通过 将 Intent 的 内 容 与 在 设备 上 
中 声明 的 Intent 过 滤器 进行 比较 ， 从 而 找到 要 启动 的 相应 组 件 。 
| 系统 将 启动 该 组 件 ， 
会 显示 一 个 对 话 框 ， 文 持 用 户 选 取 要 使 


3) 找 


puie, M 


Intent 过 滤器 是 应 用 清单 文件 
如 ， 通 过 为 Activity 声 


局 动 。 


1 
wk 
Android 系 统 


图 3-1 axl Intent 


4H- ZN 
I 


[E] 
H| 


3.3 构建 Intent 


Intent 对 象 携 带 了 Android 系统 用 来 


称 或 应 当 接 


例如， 要 采取 的 操作 以 及 要 处 到 


Intent 中 包含 


1. 组 件 名 称 


这 是 可 选项 ， 但 也 是 构建 显 


明 Intent 过 滤器 ， 可 以 使 其 他 应 
启动 Activity。 如 果 没 有 为 Activity 声明 任何 Intent 过 滤器 ， 则 Activity 只 能 通过 显 式 Intent 


的 Intent, 


2 


启动 Activity 示意 图 


? Intent 
! 
1 
T 


Oncreate() 
1 
Activity B 


3 


上 用 匹配 Activity (Activity B) 的 onCreate() 方法 并 将 


玫 将 其 传递 给 startActivity(). 
与 Intent 匹配 的 Intent 过 滤器 。 


他 应 用 的 清单 文件 


如 果 Intent 与 Intent 过 滤器 


接收 的 Intent 类 型 。 


并 向 其 传递 Intent 对 象 。 如 果 多 个 Intent 过 滤器 兼容 ， 则 系统 
用 的 应 用 。 
的 一 个 表达 式 ， 它 指定 该 组 件 要 和 


例 


定 要 启动 哪个 组 件 的 信息 “例如 ， 准 古 


收 该 Intent 的 组 件 类 别 )， 以 及 接收 信息 的 组 伯 


LE 的 数据 )。 


的 主要 信息 如 下 。 


组 件 名 称 定义 的 应 用 组 件 。 


如 果 没 有 组 件 名 称 ， 则 Intent 是 隐 式 的 ，j 


式 Intent 的 一 项 重要 信 


yo 


] 能 够 直接 使 月 


日 某 一 特定 类 型 的 Intent 


的 组 件 名 


Es 


ay? 


述 的 操作 、 数 据 和 类 别 ) 决定 哪个 组 件 应 当 接 收 Intent. 


因此 ， 如 需 帮 


EDV FH! 


Intent 的 这 一 字段 是 一 个 ComponentName 对 象 ， 可 以 使 用 目标 组 伯 


此 对 象 ， 其 ! 


包括 应 用 的 软 伯 


ARS 


味 着 Intent 应 当 仅 传递 给 | 


日 系统 将 根据 其 他 Intent 信 ， 


局 动 特定 的 组 件 ， 则 应 指定 该 组 件 的 名 称 。 


F 为 了 正确 执行 操作 而 使 用 的 信息 


有 《例如 ， 以 下 所 


的 完 
F 包 名 称 ， 例 如 ，com.example.ExampleActivity。 


JAS 


限定 类 名 指定 


m 


可 以 使 用 setComponent()、setClass()、setClassName( 或 Intent 构造 函数 设置 组 件 名 称 。 


2. 操作 


操作 是 指 要 执行 的 通 
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DR 
o 


HHE au, “AA” Be RIE”) 的 字符 串 ， 
T Intent 其 余部 分 的 构成 ， 特 别 是 数据 和 Extra 中 包含 的 内 


在 很 大 程度 上 决定 


可 以 创建 自己 的 操作 ， 但 是 ， 通 常 应 该 使 用 由 Intent 类 或 其 他 框架 类 定义 的 操作 常量 。 
以 下 是 一 些 用 于 启动 Activity 的 常见 操作 : 


(DACTION VIEW ("android.intent.action.VIEW") 


此 操作 用 于 查看 信息 例如 ， 要 使 用 图 库 应 用 查看 的 照片 ， 或 者 要 使 用 浏览 器 应 用 打开 
网 页 )， 可 以 用 Intent 将 此 操作 与 startActivity0 结合 使 用 。 


@ACTION SEND ("android.intent.action.SEND" ) 


这 也 称 为 “分 享 ” 操 作 。 可 以 用 Intent 将 此 操作 与 startActivity0 结 合 使 用 ， 分 享 数据 。 
ACTION EDIT ("android.intent.action.EDIT" ) 

此 操作 提供 对 给 定数 据 的 显 式 可 编辑 访问 。 
@ACTION PICK ("android.intent.action.PICK") 

此 操作 从 数据 中 选择 一 个 项 目 ， 返 回 所 选 的 内 容 。 
®ACTION DIAL ("android.intent.action.DIAL" ) 

此 操作 按 指定 的 号 码 拨 号 ， 会 显示 一 个 界面 ， 允 许 用 户 显 式 启 动 呼叫 。 
G@ACTION SENDTO ("android.intent.action.SENDTO" ) 

此 操作 给 指定 的 号 码 发 送 消息 。 
DACTION DELETE ("android.intent.action. DELETE") 

此 操作 从 容器 中 删除 给 定 的 数据 。 
ACTION WEB SEARCH ("android.intent.action.WEB SEARCH") 


此 操作 在 网 络 上 搜索 内 容 。 

3. 数据 

数据 包括 待 操作 数据 和 该 数据 MIME 类 型 的 URI (Uri 对 象 )。 提 供 的 数据 类 型 通常 1 
Intent 的 操作 决定 。 例 如 ， 如 果 操 作 是 ACTION_EDIT， 则 数据 应 包含 待 编辑 文档 的 URI。 

创建 Intent 时 ， 除 了 指定 URI 以 外 ， 指 定数 据 类 型 (其 MIME 类 型 ) 往往 也 很 重 
要 。 例 如 ， 能 够 显示 图 像 的 Activity 可 能 无 法 播放 音频 文件 ， 即 便 URI 格式 十 分 类 似 时 
也 是 如 此 。 因 此 ， 指 定数 据 的 MIME 类 型 有 助 于 Android 系统 找到 接收 Intent 的 最 佳 组 
件 。 但 有 时 MIME 类 型 可 以 从 URI 中 推断 得 出 ， 特 别 当 数据 是 content: URI 时 尤其 如 
此 。 这 表明 数据 位 于 设备 中 ， 且 由 ContentProvider 控制 ， 这 使 得 数据 MIME 类 型 对 系统 
可 见 。 

要 仅 设 置 数据 URI， 需 调用 setData0。 要 仅 设置 MIME 类 型 ， 则 调用 setType0。 如 有 必 
要 ， 可 以 使 用 setDataAndType() 同时 显 式 设置 两 者 。 


ll 
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注意 : 若 要 同时 设置 URI 和 MIME 类 型 ， 请 勿 调用 setData0 和 setType()， 因 为 它们 会 
互相 抵消 彼此 的 值 。 务 必 始 终 使 用 setDataAndType() 同时 设置 URI 和 MIME 类 型 。 


4. 类 别 

类 别 是 一 个 包含 应 处 理 Intent 组 件 类 型 的 附加 信息 的 字符 串 。 可 以 将 任意 数量 的 类 别 描 
述 放 入 一 个 Intent 中 ， 但 大 多 数 Intent 均 不 需要 类 别 。 

以 下 是 一 些 常 见 类 别 : 


(DCATEGORY HOME ("android.intent.category HOME") 
此 类 别 表 明 Activity 是 应 用 启动 后 ， 第 一 个 被 显示 的 Activity o 


@CATEGORY LAUNCHER ("android.intent.category. LAUNCHER") 


D 


此 类 别 表 明 Activity 是 任务 的 初始 Activity， 在 系统 的 应 用 启动 器 中 可 以 看 到 。 可 以 使 
J addCategory0 指 定 类 别 。 
以 上 列 出 的 这 些 属 性 〈 组 件 名 称 、 操 作 、 数 据 和 类 别 ) 表示 Intent 的 既定 特征 ， 通 过 读 
取 这 些 属 性 ，Android 系统 能 够 解析 应 当 启 动 哪个 应 用 组 件 。 
Intent 还 可 以 提供 以 下 信息 。 
5. Extra 
Extra 是 携带 完成 请 求 操 作 所 需 的 附加 信息 的 键 值 对 。 正 如 某 些 操作 使 用 特定 类 型 的 数 
据 URI 一 样 ， 有 些 操作 也 使 用 特定 的 Extra. 
可 以 使 用 各 种 putExtra() 函数 添加 Extra 数据 ， 每 个 函数 均 接 收 两 个 参数 : 键 名 和 值 。 
还 可 以 创建 一 个 包含 所 有 Extra 数据 的 Bundle 对 象 ， 然 后 使 用 putExtras0 将 Bundle 插入 
Intent 中 。 
例如 ， 使 用 ACTION SEND 创建 用 于 发 送 电子 邮件 的 Intent 时 ， 可 以 使 用 EXTRA 
EMAIL 键 指定 收 件 人 ， 并 使 用 EXTRA _SUBJECT 键 指定 “主题 ” 
Intent 类 为 标准 化 的 数据 类 型 指定 多 个 EXTRA * 常量 。 如 需 声明 自己 的 Extra 键 ( 对 于 
应 用 接收 的 Intent)， 需 确保 将 应 用 的 软件 包 名 称 作 为 前 级 。 
例如 : 


static final String EXTRA LOGIN ="com.example.EXTRA LOGIN"; 


6. Flag 
Flag 是 在 Intent 类 中 定义 的 、 充 当 Intent 元 数据 的 标志 。 
标志 可 以 指示 Android 系统 如 何 启动 Activity， 以 及 启动 之 后 如 何 处 理 ， 如 ; 


FLAG ACTIVITY NEW TASK 
表明 在 新 任务 中 启动 Activity。 
FLAG ACTIVITY NO HISTORY 


表明 新 的 Activity 将 在 历史 堆栈 中 不 被 保留 。 
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3.4 TA Intent 示例 


显 式 Intent 是 指 用 于 启动 某 个 特定 应 用 组 件 〈 例 如 ， 应 用 中 的 某 个 特定 Activity 或 服 
务 ) 的 Intent。 要 创建 显 式 Intent, FEA Intent 对 象 定义 组 件 名 称 ，Intent 的 所 有 其 他 属性 

例如 ， 如 果 在 应 用 中 构建 了 一 个 名 为 LogInActivity 的 Activity 用 于 登录 功能 ， 可 以 用 以 
下 代码 启动 此 Activity: 


m) 


Intent intent = new Intent(this, LogInActivity.class); 
startActivity(intent); 


Intent(Context, Class) 构造 函数 的 两 个 参数 是 Activity 的 Context 和 Class 对 象 。 


3.5 Bast Intent 示例 


如 果 当 前 的 应 用 无 法 执行 某 项 操作 ， 而 用 户 使 用 的 设备 上 其 他 应 用 可 以 ， 且 希望 用 户 选 
取 要 使 用 的 应 用 ， 那 就 可 以 使 用 隐 式 Intent. 
例如 ， 如 果 和 希望 用 户 与 他 人 分 享 内 容 ， 可 以 使 用 ACTION_SEND 操作 创建 Intent， 并 添 
加 指定 共享 内 容 的 Extra。 使 用 该 Intent 调用 startActivity0 时 ， 用 户 可 以 选取 分 享 内 容 所 使 
用 的 应 用 。 


注意 : 用 户 设备 上 可 能 没有 任何 应 用 能 够 处 理 当 前 应 用 发 送 到 startActivity) HRA 
Intent。 如 果 出 现 这 种 情况 ， 则 调用 将 会 失败 ， 且 应 用 会 崩 江 。 


要 验证 Activity 是 否 会 接收 Intent， 需 要 对 Intent 对 象 调用 resolveActivity()。 如 果 结 果 为 
非 空 ， 则 至 少 有 一 个 应 用 能 够 处 理 该 mntent， 且 可 以 安全 调用 startActivity0 。 如 果 结 果 为 
空 ， 则 不 应 使 用 该 Intent。 如 有 可 能 ， 应 停 用 发 出 该 Intent 的 功能 。 

在 App Inventor 2 的 联系 人 选择 框 组 件 的 源码 文件 ContactPickerjava 中 ， 有 如 下 代码 : 


@SimpleFunction(description = "view a contact via its URI") 
public void ViewContact(String uri) { 
if(contactUri != null) { 
Intent intent = new Intent(Intent. ACTION _VIEW,Uri.parse(uri)); 
if (intent.resolveActivity(this.activityContext.getPackageManager()) != null) { 
this.activityContext.startA ctivity (intent); 
} 
} 
} 


其 中 就 使 用 了 resolveActivity0 函 数 判 断 是 否 有 应 用 能 处 理 Intent. 
在 App Inventor 2 的 信息 分 享 器 组 件 的 源码 文件 Sharing.java ! 


有 如 下 代码 : 


~ 


@SimpleFunction(description = "Shares a message through any capable "+ 
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"application installed on the phone by displaying a list of the available apps and " + 
"allowing the user to choose one from the list. The selected app will open with the " + 
"message inserted on it.") 
public void ShareMessage(String message) { 
Intent shareIntent = new Intent(Intent. ACTION SEND); 
shareIntent.putExtra(Intent EXTRA TEXT, message); 
shareIntent.setType("text/plain"); 


// We cannot use Intent.createChooser(shareIntent, "Send using...") because it creates an 
// oversized pop up sharing window. 
this.form.startActivity(shareIntent); 

} 


上 述 代码 没有 使 用 URI， 但 声明 了 Intent 的 数据 类 型 ， 

调用 startActivity() 时 ， 系 统 将 检查 已 安装 的 所 有 应 月 
Intent. 

如 果 只 有 一 个 应 用 能 够 处 理 ， 则 该 应 用 将 立即 运行 并 为 其 处 理 Intent。 如 果 有 多 个 应 
用 能 够 处 理 Intent， 则 系统 将 显示 一 个 对 话 框 ， 使 用 户 能 够 选取 要 使 用 的 应 用 。 如 图 3-2 
所 示 。 


日 于 指定 Extra 携带 的 内 容 。 
， 确 定 哪 些 应 用 能 够 处 理 这 种 


at y 


9 "ae A 5:59 


分 享 方式 


C ”保存 到 云端 硬盘 


D ”复制 到 剪贴 板 


图 3-2 ”分享 应 用 选择 界面 
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昌 户 还 可 以 将 选择 的 应 用 设置 为 该 操作 的 默认 选项 ， 如 果 用 户 可 能 希望 今后 一 直 使 用 相 
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同 的 应 用 执行 某 项 操作 《〈 例 如， 打开 网 页 时 ， 用 户 往往 倾向 于 仅 使 用 一 种 网 络 浏览 器 )， 则 
这 一 点 十 分 有 用 。 

如 果 用 户 和 希望 每 次 使 用 不 同 的 应 用 ， 则 应 采用 显 式 方式 显示 选择 器 对 话 框 。 选 择 器 对 话 
框 每 次 都 会 要 求 用 户 选 择 执行 操作 的 应 用 。 


3.6 Intent 过 滤器 


Intent 过 滤器 主要 声明 以 下 内 容 : 
1) Intent 操作 。 

2) Intent 数据 CURI 和 数据 类 型 )。 
3) Intent 类 别 。 

示例 如 下 : 


IntentFilter intentFilter = new IntentFilter(); 
intentFilter.addAction(Intent. ACTION VIEW); 


try { 
intentFilter.addDataType("audio/mpeg"); 
} catch (IntentFilter.MalformedMimeTypeException e) 


{ 


e.printStackTrace(); 


} 
intentFilter.addCategory(Intent.CATEGORY DEFAULT); 


Intent 过 滤器 主要 有 两 个 用 途 : 

1) 系统 收 到 隐 式 Intent 以 启动 Activity 时 ， 它 根据 操作 、 数 据 和 类 别 将 该 Intent 与 
Intent 过 滤器 进行 比较 ， 搜 索 执行 该 Intent 的 最 佳 Activity。 

2) 用 Intent 的 操作 、 数 据 和 类 别 内 容 ， 确 定 消息 接收 器 要 接收 的 Intent 广播 。 

在 App Inventor 2 中 ，Intent 过 滤器 主要 用 于 第 2 个 用 途 。 

如 在 电话 拨号 器 组 件 的 源码 文件 PhoneCall.java 中 ， 有 如 下 代码 : 


private void registerCallState Monitor() { 
IntentFilter intentFilter = new IntentFilter(); 
intentFilter.addAction(Intent ACTION NEW OUTGOING CALL); 
intentFilter.addAction(TelephonyManager.ACTION PHONE STATE CHANGED); 
context.registerReceiver(callStateReceiver, intentFilter); 


} 


上 述 代 码 定制 消息 接收 器 接收 Intent ACTION NEW OUTGOING CALL 和 TelephonyManager 
ACTION PHONE STATE_ CHANGED 两 个 Intent 广播 。 
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542% Broadcast 介绍 


4.1 Broadcast 机 制 概述 


在 Android 系统 中 ， 要 使 用 广播 ， 需 要 有 广播 发 送 者 和 广播 接收 者 ， 通 常情 况 下 ， 
BroadcastReceiver 指 的 就 是 广播 接收 者 (广播 接收 器 )。 
广播 作为 Android 组 件 间 的 通信 方式 ， 可 以 使 用 的 场景 如 下 : 
1) 应 用 内 部 的 消息 通信 。 
2) 不 同 应 用 之 间 的 消息 通信 。 
3) Android 系统 在 特定 情况 下 与 应 用 之 间 的 消息 通信 。 
App Inventor 2 系统 中 使 用 广播 主要 是 在 Android 系统 与 应 用 间 进 行 消息 通信 。 


4.2 BroadcastReceiver 


自 定 义 广 播 接 收 吉 需要 继承 基 类 BroadcastReceiver， 并 实现 抽象 函数 onReceive(context, 
intent)。 广 播 接 收 器 接收 到 相应 广播 后 ， 会 自动 调用 onReceive() KAŽ 

默认 情况 下 ， 广 播 接收 器 也 是 运行 在 主线 程 ， 因 此 ，onReceive 函数 中 不 能 执行 太 耗 时 
的 操作 (不 要 超过 10s)， 否 则 将 会 产生 ANR (Application Not Responding) 问题 。 

onReceive 函数 中 涉及 与 其 他 组 件 之 间 的 交互 ， 可 以 用 发 送 Notification, JAZ Service 等 
方式 ， 最 好 不 要 启动 Activity。 

BroadcastReceiver 总 体 上 可 以 分 为 两 种 注册 方式 : 静态 注册 和 动态 注册 。 


4.2.1 静态 注册 
静态 注册 是 指 直 接 在 AndroidManifest.xml 文件 中 进行 注册 ， 涉 及 的 相关 属性 如 下 : 


<receiver android:directBootAware=["true" | "false"| 
android:enabled=["true" | "false"] 
android:exported=["true" | "false"] 
android:icon="drawable resource" 
android:label="string resource" 
android:name="string" 
android:permission="string" 
android:process="string" > 


</receiver> 
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其 中 ， 以 下 两 个 属性 需 特别 关注 : 

1) android:exported 此 BroadcastReceiver 能 否 接收 其 他 应 用 发 出 的 广播 ， 
false 时 ， 只 能 接收 同一 应 用 的 组 件 ， 或 具有 相同 user ID 的 应 用 发 送 的 消息 。 

这 个 属性 的 默认 值 是 由 receiver 中 有 无 intent-filter 决定 的 ， 如 果 有 intent-filter， 
J true, FU falses 


当 设 为 


默认 值 


2) android:permission 一 一 如 果 设 置 ， 具 有 相应 权限 的 广播 发 送 方 发 送 的 广播 才能 被 此 


BroadcastReceiver 所 接收 ;如 果 没 有 设置 ， 属 性 的 值 就 是 整个 应 用 所 申请 的 权限 。 
常见 的 注册 形式 如 下 : 
<receiver android:name=".FamBroadcastReceiver" android:exported="true"> 
<intent-filter> 
<action android:name="android.intent.action. BOOT COMPLETED" /> 
<action android:name="android.intent.action.INPUT_METHOD_CHANGED" /> 
</intent-filter> 


</receiver> 


4.2.2 HASTE 


动态 注册 时 ， 无 须 在 AndroidManifest.xml 文件 中 注册 <receiver> 组 件 ， 直 接 在 代码 中 通 


上 


过 调用 Context 的 registerReceiver 函数 ， 可 以 动态 注册 BroadcastReceiver。 


在 App Inventor 2 中 ， 采 用 的 注册 类 型 主要 是 动态 注册 。 在 电话 拨号 器 组 件 的 源码 文件 


PhoneCall.java 中 ， 有 如 下 代码 : 
/注册 广播 接收 器 


private void registerCallState Monitor() { 
IntentFilter intentFilter = new IntentFilter(); 
intentFilter.addAction(Intent ACTION NEW OUTGOING CALL); 
intentFilter.addAction(TelephonyManager.ACTION PHONE STATE CHANGED); 
context.registerReceiver(callStateReceiver, intentFilter); 


} 


= 


private void unregisterCallStateMonitor() { 
context.unregisterReceiver(callStateReceiver); 


} 

/销毁 Activity 时 取消 注册 广播 接收 器 ; 

@Override 

public void onDestroy() { 
unregisterCallStateMonitor(); 


} 


43 系统 广播 


Android 系统 中 内 置 了 多 个 系统 广播 (System Broadcast)， 只 要 涉及 手机 的 基本 操作 ， 
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基本 


上 都 会 发 出 相应 的 系统 广播 ， 如 开机 启动 、 网 络 状态 改变 和 电量 不 足 等 。 每 个 系统 广播 


都 具 


有 特定 的 intent-filter， 其 中 主要 包括 具体 的 action， 系 统 广播 发 出 后 ， 将 被 相应 的 


BroadcastReceiver 接收 。 系 统 广 播 由 系统 内 部 在 特定 事件 发 生 时 自动 发 出 。 
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以 下 是 几 个 定义 系统 广播 的 字符 串 常 量 : 


/设备 进入 低 电量 状态 
ACTION BATTERY LOW ("android.intent.action. BATTERY LOW") 


/用 户 打开 或 关闭 飞行 模式 
ACTION AIRPLANE MODE CHANGED ("android.intent.action.AIRPLANE_MODE") 


/网 络 连接 发 生 了 变化 
CONNECTIVITY ACTION ("android.net.conn.CONNECTIVITY CHANGE") 


5.1 权限 简介 


权限 是 Android 系统 内 置 的 一 种 限制 ， 用 于 限制 对 部 分 代码 或 设备 上 数据 的 访问 。 施 加 
限制 是 为 了 保护 可 能 被 误 用 以 致 破坏 或 损害 用 户 体 验 的 关键 数据 和 代码 。 

如 果 应 用 需要 访问 受权 限 保护 的 功能 ， 则 必须 在 清单 文件 中 使 用 <uses-permission> 元 素 
声明 应 用 需要 该 权限 。 将 应 用 安装 到 设备 上 时 ， 安 装 程序 会 检查 签署 应 用 证 书 的 颁发 机 构 3 
(在 某 些 情况 下 〉 询 问 用 户 确 定 是 否 授 予 请 求 的 权限 。 如 果 授 予 权 限 ， 则 应 用 能 够 使 用 受 保 
护 的 功能 ， 和 否则 ， 其 访问 这 些 功 能 的 尝试 将 会 失败 ， 并 且 不 会 向 用 户 发 送 任何 通知 。 


5.2 ”常用 权限 说 明 


每 种 权限 均 由 一 个 字符 串 标 识 ， 指 示 受 限制 的 操作 。 以 下 是 Android 系统 定义 的 一 些 权 
限 字 符 串 : 


/设置 墙纸 
android.permission.SET WALLPAPER 


/获取 设备 的 联网 状态 
android.permission. ACCESS NETWORK STATE 


/改变 网 络 连接 状态 
android.permission.CHANGE NETWORK STATE 


/获取 设备 的 WIFI 状态 
android.permission.ACCESS WIFI STATE 


/改变 WIFI 连接 状态 
android.permission.CHANGE WIFI STATE 


/使 用 蓝牙 功能 
android.permission. BLUETOOTH 
android.permission. BLUETOOTH_ADMIN 


/使 用 内 光 灯 
android.permission. FLASHLIGHT 
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/连接 网 络 
android.permission. INTERNET 


/接收 开机 广播 
android.permission.RECEIVE_BOOT_COMPLETED 


/使 用 震动 功能 
android.permission. VIBRATE 


/使 用 照相 机 功能 
android.permission. CAMERA 


/使 用 定位 功能 
android.permission.ACCESS FINE LOCATION 
android.permission.ACCESS COARSE LOCATION 


// 使 用 录音 功能 
android.permission.RECORD AUDIO 


// 读 取 手 机 状态 ， 包 括 设备 的 电话 号 个、 当前 的 蜂窝 网 络 信 | 
android.permission.READ PHONE STATE 


/拨打 电话 
android.permission.CALL _ PHONE 


/处 理 接收 到 的 电话 
android.permission. ANSWER PHONE CALLS 


/ 读 写 通话 记录 
android.permission.READ CALL LOG 
android.permission.WRITE_ CALL LOG 


/发 送 、 接 收 和 读 取 短信 
android.permission.SEND_ SMS 
android.permission.RECEIVE SMS 
android.permission. READ SMS 


/接收 WAP PUSH 和 彩信 
android.permission.RECEIVE WAP PUSH 
android.permission.RECEIVE MMS 


/ 读 写 存储 空间 
android.permission.READ EXTERNAL STORAGE 
android.permission. WRITE EXTERNAL STORAGE 


EAEE 


行 的 通话 状态 等 


Bor 注解 介绍 


注解 就 是 代码 的 元 数据 《元 数据 是 一 种 描述 数据 的 数据 )， 可 以 声明 在 类 、 变 量 、 函 数 
和 函数 参数 等 的 前 面 ， 用 来 对 这 些 元 素 进 行 说 明 。 下 面 介 绍 App Inventor 2 源码 中 使 用 到 的 
一 些 注解 


Fo 


6.1 DesignerComponent 


此 注解 用 于 标记 组 件 设 计时 使 用 的 组 件 ， 源 码 文件 为 DesignerComponent.java， 代 人 码 
如 下 : 


package com.google.appinventor.components.annotations; 
import com.google.appinventor.components.common.ComponentCategory; 


import java.lang.annotation.ElementType; 
import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 


import java.lang.annotation. Target; 


/注解 会 被 保存 在 class 文件 中 ， 在 运行 时 可 以 通过 反射 获取 到 
@Retention(RetentionPolicy. RUNTIME) 


/注解 的 作用 目标 是 类 或 接 
@Target(ElementType.TYPE) 
public @interface DesignerComponent { 

ComponentCategory category() default ComponentCategory. UNINITIALIZED; 


String description() default ""; 

String designerHelpDescription() default ""; 
boolean showOnPalette() default true; 
boolean nonVisible() default false; 

String iconName() default ""; 


int version(); 
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String helpUrl() default ""; 
} 


Category: 组 件 的 类 型 ， 可 取 的 值 如 下 : 


public enum ComponentCategory { 
USERINTERFACE("User Interface"), 


LAYOUT("Layout"), 
MEDIA("Media"), 


ANIMATION("Drawing and Animation"), 


SENSORS("Sensors"), 
SOCIAL("Social"), 
STORAGE("Storage"), 


CONNECTIVITY ("Connectivity"), 

LEGOMINDSTORMS("LEGO\WOOAE MINDSTORMS\u00AE"), 

EXPERIMENTAL("Experimental"), 

EXTENSION("Extension"), 

INTERNAL("For internal use only"), 

// UNINITIALIZED is used as a default value so Swing libraries can still compile 
UNINITIALIZED ("Uninitialized"); 


} 


description 和 designerHelpDescription 的 内 容 是 关于 此 组 件 的 一 些 说 明文 字 ， 通 常 只 需 给 


description 赋值 就 可 以 了 。 


在 组 件 面板 界面 ， 单 击 某 个 组 件 右边 的 问号 图 标 ， 就 会 显示 description 的 内 容 ， 如 图 6-1 


所 示 。 
组 件 面板 
用 户 界面 
按钮 
v 复 选 框 


日 期 选择 框 


Ka 


showOnPalette: 是 否 在 组 件 面板 ， 


6-1 


nonVisible: 是 否 在 UI 界面 


上 显 


组 件 description 内 容 显 示 界 面 


显示 此 组 件 ， 默 认为 true。 


工作 面板 
显示 隐藏 组 件 


Fe SPE IN| re Lh E 


用 户 通过 和 触 碰 按 钮 来 完成 应 用 中 的 某 些 动 | 
作 。 按 钮 可 以 感知 用 户 的 触 碰 ; 可 以 改变 按 

钮 的 某 些 外 观 特性 。 如 启用 属性 可 以 决定 按 

钮 是 否 能 够 感知 到 触 碰 。 


ANY 


iconName: 组 件 的 图 标 文 件 名 称 。 


version: 组 件 的 版 本 号 。 
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比 组 件 ， 即 是 否 是 非 可 视 组 件 ， 默 认为 false。 


helpUrl: 组 件 帮助 文档 的 URL 地 址 ， 主 要 是 给 插件 用 的 。 


6.2 SimpleObject 


此 注解 用 于 标记 对 象 ， 源 码 文件 为 SimpleObjectjava， 代 码 如 下 : 
package com.google.appinventor.components.annotations; 


import java.lang.annotation.ElementType; 
import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 
import java.lang.annotation. Target; 


@Retention(RetentionPolicy. RUNTIME) 
@Target(ElementType.TYPE) 
public @interface SimpleObject { 


boolean external() default false; 


} 


external: 表示 组 件 是 否 是 外 部 组 件 ， 默 认 值 为 false。 如 果 设 为 tue， 会 根据 组 件 的 java 
文件 生成 aix 文件 ， 主 要 用 于 插件 开发 。 


TT 


6.3 UsesPermissions 


此 注解 用 于 声明 组 件 用 到 的 Android 系统 权限 ， 源 码 文件 为 UsesPermissions.java, {U4 
如 下 : 


package com.google.appinventor.components.annotations; 


import java.lang.annotation.ElementType; 
import java.lang.annotation. Retention; 
import java.lang.annotation.RetentionPolicy; 
import java.lang.annotation. Target; 


@Retention(RetentionPolicy. RUNTIME) 
@Target(ElementType.TYPE) 
public @interface UsesPermissions { 


String permissionNames() default ""; 


j 
， 一 次 可 声明 多 个 权限 ， 中 间 用 去 号 


Ud 


permissionNames: Android 系统 权限 名 称 字符 虽 
Ma JF o 


6.4 DesignerProperty 


此 注解 用 于 声明 组 件 的 属性 在 组 件 属 性 面板 中 可 见 ， 组 件 属性 的 setter 函数 必须 用 此 注 


解 声 明 ， 源 但 文件 为 DesignerPropertyjava， 代 但 如 下 : 
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package com.google.appinventor.components.annotations; 

import com.google.appinventor.components.common.PropertyTypeConstants; 
import java.lang.annotation.ElementType; 

import java.lang.annotation.Retention; 

import java.lang.annotation.RetentionPolicy; 


import java.lang.annotation. Target; 


@Retention(RetentionPolicy. RUNTIME) 


/此 注解 的 作用 目标 是 方法 ， 也 就 是 函数 
@Target(ElementType.METHOD) 
public @interface DesignerProperty { 


String editorType() default Property TypeConstants. PROPERTY TYPE TEXT; 


String defaultValue() default ""; 
j 


editorType: 属性 的 参数 类 型 ， 常 用 的 类 型 有 以 下 儿 个 。 


public class PropertyTypeConstants { 
able static final String PROPERTY TYPE BOOLEAN = "boolean"; 
public static final String PROPERTY TYPE FLOAT = "float"; 
public static final String PROPERTY TYPE INTEGER = "integer"; 
public static final String PROPERTY TYPE NON NEGATIVE FLOAT ="non_negative float"; 


public static final String PROPERTY TYPE NON NEGATIVE INTEGER = "non_negative_ 
integer"; 


/这 两 个 类 型 是 一 样 的 ， 优 先 使 用 PROPERTY _ TYPE _ STRING 
public static final String PROPERTY TYPE STRING = "string"; 
public static final String PROPERTY TYPE TEXT = "text"; 


public static final String PROPERTY TYPE VISIBILITY = "visibility"; 


6.5 SimpleProperty 


此 注解 用 于 声明 组 件 的 属性 ， 属 性 的 getter 和 setter 函数 都 必须 用 此 注解 声明 ， 源 人 码 文 
件 为 SimplePropertyjava， 代 码 如 下 : 


package com.google.appinventor.components.annotations; 


import java.lang.annotation.ElementType; 
import java.lang.annotation. Retention; 
import java.lang.annotation.RetentionPolicy; 
import java.lang.annotation. Target; 


@Retention(RetentionPolicy. RUNTIME) 
@Target(ElementType: METHOD) 
public @interface SimpleProperty { 


String description() default ""; 


PropertyCategory category() default PropertyCategory. UNSET; 


boolean userVisible() default true; 


} 


description 的 内 容 为 属性 的 说 明文 字 。 
在 工作 面板 界面 ， 当 把 鼠标 移动 到 设置 或 获取 属性 值 的 代码 块 上 时 ， 就 会 
description 的 内 容 ， 如 图 6-2 所 示 。 


| 


Si 
NI 
pA 


工作 面板 


If set, user can tap check box to cause action. 


图 6-2 


Hl 


性 的 description 内 容 显示 界 国 


category: 属性 的 类 型 ， 该 变量 要 么 用 于 getter 函数 ， 要 么 用 于 setter 函数 ， 不 需要 两 个 
函数 都 使 用 。 可 取 的 值 如 下 : 


public enum PropertyCategory { 
BEHAVIOR("Behavior"), 
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APPEARANCE("Appearance"), 
DEPRECATED("Deprecated"), 
UNSET("Unspecified"); 


} 


userVisible: 设置 属性 是 否 能 通过 代码 块 访 问 ， 默 认为 true。 


6.6 SimpleFunction 


此 注解 用 于 声明 组 件 的 功能 函数 ， 源 人 码 文件 为 SimpleFunction.java， 代 码 如 下 : 


package com.google.appinventor.components.annotations; 


import java.lang.annotation.ElementType; 
import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 
import java.lang.annotation. Target; 


@Retention(RetentionPolicy. RUNTIME) 
@Target(ElementType. METHOD) 
public @interface SimpleFunction { 


String description() default ""; 


boolean userVisible() default true; 


} 


description 的 内 容 为 此 函数 的 说 明文 字 。 
在 工作 面板 界面 ， 当 把 鼠标 移动 到 函数 的 代码 块 上 时 ， 就 会 显示 description 的 内 容 ， 如 
6-3 所 示 。 


页 


Dismiss a previously displayed ProgressDialog box 


调用 GHAD .错误 日 志 
消息 


图 6-3 ”功能 函数 的 description A Ae AN FL 


6 
userVisible: 设置 能 和 否 通过 代码 块 访 问 此 函数 ， 默 认为 true。 


6.7 SimpleEvent 


此 注解 用 于 声明 组 件 的 事件 响应 函数 ， 源 码 文件 为 SimpleEvent.java， 代 人 码 如 下 : 
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package com.google.appinventor.components.annotations; 


import java.lang.annotation.ElementType; 
import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 


import java.lang.annotation. Target; 


@Retention(RetentionPolicy. RUNTIME) 
@Target(ElementType: METHOD) 
public @interface SimpleEvent { 


String description() default ""; 


boolean userVisible() default true; 


} 


description 的 内 容 为 此 函数 的 说 明文 字 。 
在 工作 面板 界面 ， 当 把 鼠标 移动 到 函数 的 代码 块 上 时 ， 就 会 显示 description 的 内 容 ， 如 
6-4 TAN 


而 


工作 面板 


User tapped and released the button. 


Lin! 


图 6-4 


事件 响应 函数 的 description 内 容 显示 界面 


userVisible: 设置 能 否 通过 代码 块 访 问 此 函数 ， 默 认为 true。 


6.8 UsesBroadcastReceivers 


此 注解 用 于 声明 组 件 使 用 的 广播 接收 器 ， 源 码 文件 为 UsesBroadcastReceivers.java, (th 
如 下 : 
package com.google.appinventor.components.annotations; 
import com.google.appinventor.components.annotations.androidmanifest.ReceiverElement; 
import java.lang.annotation.ElementType; 
import java.lang.annotation.Retention; 


import java.lang.annotation.RetentionPolicy; 
import java.lang.annotation. Target; 
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@Retention(RetentionPolicy. RUNTIME) 

@Target(ElementType. TYPE) 

public @interface UsesBroadcastReceivers { 
ReceiverElement[] receivers(); 


} 
receivers: 接收 器 数组 。 


6.9 ReceiverElement 


此 注解 用 于 声明 组 件 使 用 的 广播 接收 器 的 各 属性 ， 源 码 文件 为 ReceiverElement， 代 码 
如 下 : 


A 


package com.google.appinventor.components.annotations.androidmanifest; 
import java.lang.annotation.ElementType; 
import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 
import java.lang.annotation. Target; 
@Retention(RetentionPolicy. RUNTIME) 
@Target(ElementType.TYPE) 
public @interface ReceiverElement { 
IntentFilterElement[] intentFilters() default {}; 
MetaDataElement[] metaDataElements() default {}; 
String name(); 
String enabled() default ""; 
String exported() default ""; 
String icon() default ""; 
String label() default ""; 


String permission() default ""; 


String process() default ""; 
} 
intentFilters: Intent 过 滤器 数组 。 
metaDataElements: 元 数据 数组 。 
name: 广播 接收 器 的 类 名 。 
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enabled: 广播 接收 器 能 否 被 系统 实例 化 。 

exported: 广播 接收 器 能 否 接收 从 本 应 用 之 外 发 来 的 消息 。 

icon: 广播 接收 器 的 图 标 。 

label: 广播 接收 器 的 文字 标签 。 

permission: 给 广播 接收 器 发 送 消 息 的 发 送 方 必须 拥有 的 权限 名 称 。 
process: 广播 接收 器 所 属 进程 的 名 称 。 


6.10 IntentFilterElement 


此 注解 用 于 声明 广播 接收 器 的 Intent 过 滤器 属性 ， 源 人 码 文件 为 IntentFilterElement.java， 
代码 如 下 : 


package com.google.appinventor.components.annotations.androidmanifest; 
public @interface IntentFilterElement { 

ActionElement[] actionElements(); 

CategoryElement[] categoryElements() default {}; 

DataElement[] dataElements() default {}; 

String icon() default ""; 

String label() default ""; 

String priority() default ""; 


} 


actionElements: Intent 操作 数组 。 

categoryElements: Intent 类 别 数组 。 

dataElements: Intent 类 别 数组 。 

icon 和 label: Intent 过 滤器 的 网 标 和 文字 标签 。 

priority: 广播 接收 器 处 理 此 Intent 过 滤器 确定 的 Intent 广播 的 优先 级 。 


6.11 ActionElement 


此 注解 用 于 声明 Intent 操作 名 称 ， 源 码 文件 为 ActionElementjava， 代 码 如 下 : 


package com.google.appinventor.components.annotations.androidmanifest; 


import java.lang.annotation.ElementType; 
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import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 


import java.lang.annotation. Target; 
@Retention(RetentionPolicy. RUNTIME) 
@Target(ElementType.TYPE) 

public @interface ActionElement { 


String name(); 


} 
name: 操作 的 名 称 。 


6.12 UsesLibraries 


此 注解 用 于 声明 使 用 到 的 库 文件 ， 源 码 文 件 为 UsesLibraries， 代 码 如 下 : 


package com.google.appinventor.components.annotations; 


import java.lang.annotation.ElementType; 
import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 


import java.lang.annotation. Target; 


/[** 


* Annotation to indicate library files required by components. 
* 


* @author ralph.morelli@trincoll.edu 

>i 
@Retention(RetentionPolicy. RUNTIME) 
@Target(ElementType.TYPE) 
public @interface UsesLibraries { 


TEE 


* The names of the libraries separated by commas. 
* 


*@return the library name 
* @see android. Manifest.permission 
*/ 

String libraries() default ""; 


} 
libraries: 库 文 件 名 称 。 
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S572 Screen 的 定制 


Screen 是 App Inventor 2 开发 使 用 的 最 基础 组 件 ， 是 一 个 容器 框架 ， 其 余 组 件 都 附着 在 
这 个 组 件 上 ， 其 对 应 的 源码 文件 为 


/appinventor/components/src/com/google/appinventor/components/ runtime/Form.java 


7.1 ”功能 菜单 的 修改 


使 用 App Inventor 2 开发 的 应 用 ， 每 个 Screen 都 默认 有 两 个 功能 菜单 :“Stop this 
application” #1 “About this application”， 显 示 的 字符 串 都 是 英文 ， 且 常用 的 “设置 ”和 “更 
新 版 本 ” 荣 单 也 没有 ， 用 户 体 验 不 好 。 

现 修改 Form.java 的 代码 ， 修 改 原 有 菜单 显示 的 字符 串 为 中 文 和 增加 功能 菜单 ， 有 具体 
如 下 。 

7.1.1 原 有 莱 单 的 修改 


“Stop this application” 和 “About this application” 两 个 菜单 使 用 的 字符 串 都 是 英文 ， 为 
方便 使 用 ， 修 改 为 中 文 。 代 码 如 下 : 


// “Stop this application ”菜单 函数 
public void addExitButtonToMenu(Menu menu) { 
/1 表示 此 荣 单 在 菜单 列表 中 排 在 第 1 位 ， 就 是 索引 值 为 1 
Menultem stopApplicationItem = menu.add(Menu.NONE, Menu.NONE, 1, //Menu.FIRST, 
//"Stop this application") 
"退出 ") 
.setOnMenultemClickListener(new OnMenultemClickListener() { 
public boolean onMenultemClick(Menultem item) { 
// 单 击 菜单 调用 的 函数 
showExitApplicationNotification(); 
return true; 


J) 
REPS fos 
stopApplicationItem.setIcon(android.R.drawable.ic_menu_close_clear_cancel); 


} 


/ “About this application” JEPE PK ži 
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public void addAboutInfoToMenu(Menu menu) { 
Menultem aboutAppItem = menu.add(Menu.NONE, Menu.NONE, 2, //2, 
//"About this application") 
mea) 
.setOnMenultemClickListener(new OnMenultemClickListener() { 
public boolean onMenultemClick(Menultem item) { 
showAboutA pplicationNotification(); 
return true; 
} 
J} 


aboutAppItem.setIcon(androld.R.drawable.ic menu info _ details); 


private void showExitApplicationNotification() { 
//String title = "Stop application?"; 
//String message = "Stop this application and exit? You'll need to relaunch " + 
// "the application to use it again."; 
//String positiveButton = "Stop and exit"; 
//String negativeButton = "Don't stop"; 
String title = "提示 "; 
String message = "确定 要 退出 应 用 ? "; 


" 


String positiveButton = "确定 "; 


String negativeButton = "取消 "; 
// These runnables are passed to twoButtonAlert. They perform the corresponding actions 
// when the button is pressed. Here there's nothing to do for "don't stop" and cancel 
Runnable stopApplication = new Runnable() {public void run () {closeApplicationFromMenu();} }; 
Runnable doNothing = new Runnable () {public void run() {}}; 
Notifier.twoButtonDialog( 

this, 

message, 

title, 

positiveButton, 

negativeButton, 

false, // cancelable is false 

stopA pplication, 

doNothing, 

doNothing); 


private void showAboutApplicationNotification() { 
//String title = "About this app"; 


String title = "关于 "; 


String MITtagline = "<p><small><em>Invented with MIT App Inventor<br>appinventor.mit.edu 
</em></small></p>"; 


// Users can hide the taglines by including an HTML open comment <!-- in the about screen message 
//String message = aboutScreen + MITtagline + yandexTranslateTagline; 
String message = aboutScreen; 


message = message.replaceAll("\\n", "<br>"); // Allow for line breaks in the string. 
//String buttonText ="Got it"; 
String buttonText =" 确 定 "; 


Notifier.oneButtonAlert(this, message, title, buttonText); 


7.1.2 ”增加 设置 新 增 菜 单 的 届 性 
为 了 使 开发 人 员 能 够 比较 灵活 地 使 用 “设置 ”和 “更 新 版 本 ”菜单 ， 增 加 两 个 属性 以 动 
态 设 置 是 否 增加 这 两 个 菜单 。 代 人 码 如 下 : 


// 增 加 变量 标识 是 否 显 示 “ 设 置 ” 和 “更 新 版 本 ” 羔 单 
private boolean isSettingMenu; 


private boolean isUpdateMenu; 


// 增 加 属性 的 获取 和 设置 函数 
@SimpleProperty(category = PropertyCategory. APPEARANCE, 
description = "设置 是 否 显示 设置 菜单 ) 
public boolean IsSettingMenu() { 
return isSettingMenu; 


@DesignerProperty(editorType = PropertyTypeConstants. PROPERTY TYPE BOOLEAN, 
defaultValue = "False") 
@SimpleProperty 
public void IsSettingMenu(boolean isSettingMenu) { 
this.isSettingMenu = isSettingMenu; 


@SimpleProperty(category = PropertyCategory. APPEARANCE, 
description = "设置 是 否 显示 更 新 App 374") 
public boolean IsUpdateMenu() { 
return isUpdateMenu; 


@DesignerProperty(editorType = PropertyTypeConstants. PROPERTY TYPE BOOLEAN, 
defaultValue = "False") 
@SimpleProperty 
public void IsUpdateMenu(boolean isUpdateMenu) { 
this.isUpdateMenu = isUpdateMenu; 
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定义 好 属性 后 ， 还 需要 在 OdeMessages.java 中 添加 属性 的 声明 : 


Wh 


@DefaultMessage("IsSettingMenu") 
@Description("") 
String IsSettingMenuProperties(); 


@DefaultMessage("IsUpdateMenu") 
@Description("") 
String IsUpdateMenuProperties(); 


到 目前 为 止 ， 已 经 成 功 添加 了 属性 ， 可 以 正常 使 用 了 ， 但 属性 名 称 在 中 文 环 境 下 也 显示 
为 英文 ， 需 要 在 OdeMessages_zh_CN.properties 中 添加 中 文字 符 串 : 


IsSettingMenuProperties = 是 否 显示 设置 菜单 


IsUpdateMenuProperties = 是 否 显示 更 新 版 本 菜单 


7.1.3 ”新 增 菜 单 的 实现 


世 


/创建 选 项 菜单 时 ， 根 据 isSettingMenu 和 isUpdateMenu 的 值 ， 确 定 是 否 新 增 菜 和 
@Override 
public boolean onCreateOptionsMenu(Menu menu) { 


// This procedure is called only once. To change the items dynamically 
// we would use onPrepareOptionsMenu. 
super.onCreateOptionsMenu(menu); 

// add the menu items 

// Comment out the next line if we don't want the exit button 
addExitButtonToMenu(menu); 

addAboutInfoToMenu(menu); 


if (isSettingMenu) { 
addSettingToMenu(menu); 


if (isUpdateMenu) { 
addUpdateToMenu(menu); 


for (OnCreateOptionsMenuL istener onCreateOptionsMenuL istener : onCreateOptionsMenuL isteners) { 
onCreateOptionsMenuListener.onCreateOptionsMenu(menu); 


} 


return true; 


// i 菜单 
public void addSettingToMenu(Menu menu) { 
Menultem updateApplItem = menu.add(Menu.NONE, Menu.NONE, 3, 
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//"About this application") 
"设置 ") 
.setOnMenultemClickListener(new OnMenultemClickListener() { 
public boolean onMenultemClick(Menultem item) { 
Setting(); 
return true; 
} 
J) 


updateA ppItem.setIcon(android.R.drawable.ic_menu_preferences); 


/ “更 新 版 本 ” 荣 单 
public void addUpdateToMenu(Menu menu) { 
if (!isSettingMenu) { 
Menultem updateApplItem = menu.add(Menu.NONE, Menu.NONE, 3, 
//"About this application") 
"更 新 版 本 ") 
.setOnMenultemClickListener(new OnMenultemClickListener() { 
public boolean onMenultemClick(Menultem item) { 
Update(); 
return true; 


} 
J) 
updateAppltem.setIcon(android.R.drawable.ic_menu more); 
yelse { 
Menultem updateAppItem = menu.add(Menu.NONE, Menu.NONE, 4, 
//" About this application") 
"更 新 版 本 ") 
.setOnMenultemClickListener(new OnMenultemClickListener() { 
public boolean onMenultemClick(Menultem item) { 
Update(); 
return true; 
} 
J) 


updateAppltem.setIcon(android.R.drawable.ic_menu more); 


} 


因为 不 确定 开发 人 员 其 体 要 实现 怎样 的 设置 功能 和 更 新 版 本 功能 ， 现 提供 两 个 事件 响应 
函数 供 开发 人 员 调用 : 


@SimpleEvent(description = " 单 击 设置 菜 
public void Setting() { 


单 的 响应 函数 几 


EventDispatcher.dispatchEvent(this, "Setting"); 


@SimpleEvent(description = " 单 击 更 新 版 本 菜单 的 响应 函数 ") 
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public void Update() { 
EventDispatcher.dispatchEvent(this, "Update"); 


} 
定义 好 函数 后 ， 还 需要 在 OdeMessages java 中 添加 函数 的 声明 : 


@DefaultMessage("Setting") 
@Description("") 
String SettingEvents(); 


@DefaultMessage("Update") 
@Description("") 
String UpdateEvents(); 


在 OdeMessages_zh CN.properties 中 添加 中 文字 符 串 : 


SettingEvents = 单 击 设置 菜单 的 响应 函数 
UpdateEvents = 单 击 更 新 版 本 羔 单 的 响应 函数 


译 、 运 行 系统 后 ， 在 组 件 属性 中 ， 可 以 看 到 多 了 “是 否 显示 设置 菜单 ”和 “是 否 显示 
更 新 版 本 菜单 ” 两 个 属性 默认 为 不 显示 ， 如 图 7-1 所 示 。 


是 否 显示 设置 菜单 


或 


否 显示 更 新 版 本 菜单 


开 屏 动画 
默认 效果 ~ 


图 7-1 新 增 属性 

在 工作 面板 界面 ， 可 以 看 到 多 了 “ 单 击 设置 菜单 的 响应 函数 ”和 “ 单 击 更 新 版 本 菜单 的 
响应 函数 ”两 个 事件 响应 函数 ， 以 及 多 了 “是 否 显 示 设 置 ”菜单 和 “是 和 否 显示 更 新 版 本 ” 菜 
单 两 个 属性 的 getter 和 setter 函数 ， 如 图 7-2 和 图 7-3 所 示 。 


工作 面板 
工作 面板 
‘Screen - WW BAG TREERE -) 
当 单 击 设置 菜单 的 响应 函数 人 
执行 p4 A Screen1 ~ M 是 否 显示 设置 菜单 v Py) 


当 . 单 击 更 新 版 本 菜单 的 响应 函数 
执行 


事件 啊 应 函数 图 7-3 新 增 属性 函数 


图 7-2 新 


当选 中 显示 “设置 ”菜单 和 “更 新 版 本 ”菜单 ， 编 译 并 运行 应 用 后 ， 单 击 设备 上 的 菜单 
键 ， 在 应 用 界面 的 底部 会 显示 4 个 中 文 功能 菜单 ， 如 图 7-4 所 示 。 


ails 
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图 7-4 功能 菜单 


提示 


单 击 “退出 ”功能 荣 单 ， 显 示 中 文 提 示 


E, WE 7-5 所 示 。 


确定 要 退出 应 用 ? 


确定 


图 7-5 “退出 ”功能 菜单 


“ 单 击 设置 菜单 的 响应 函数 ”和 “ 单 


用 示例 代码 如 图 7-6 和 图 7-7 所 示 。 


U 


5 更 


所 版 本 菜单 的 响应 函数 ”两 个 事件 响应 函数 使 


当 单 击 设置 菜单 的 响应 函数 
执行 ， 打 开 另 一 屏幕 屏幕 名 称 “ 


图 7-6 代码 1 


| 当 EE . 单 击 更 新 版 本 菜单 的 响应 函数 
HT 设置 CEED . 为 


医 志 Actvity 捕 动 中 1- Ei 
Ci 启动 活动 对 象 


从 之 前 Activity 介绍 章节 可 知 ， 当 


用 使 用 的 内 存 ， 这 样 当 Activity 再 次 进入 到 恢复 状态 后 ， 应 用 的 数据 可 能 会 于 失 。 而 且 


图 7-7 代码 2 


在 单 击 “ 设 置 ” 菜 单 的 时 候 ， 跳 转 到 设置 界面 ， 单 击 “ 更 新 版 本 ”菜单 的 时 候 ， 跳 转 到 
个 展示 新 版 应 用 信息 的 网 页 ， 可 以 下 载 新 版 本 。 


7.2 ”增加 暂停 和 恢复 状态 事件 响应 函数 


Activity 进入 到 暂停 状态 后 ， 系 统 可 能 会 回收 当前 应 
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| 


Activity 进入 到 暂停 状态 后 ， 用 户 无 法 再 看 到 当前 屏幕 ， 需 要 停止 播放 动画 、 视 频 等 ， 当 
Activity 进入 到 恢复 状态 后 ， 需 要 重新 播放 动画 、 视 频 等 。 
在 App Inventor 2 F, Form 就 对 应 Activity， 可 以 在 Form 中 增加 两 个 事件 函数 :“ 当 前 
屏幕 进入 暂停 状态 ”和 “当前 屏幕 恢复 运行 状态 ”， 开 发 人 员 可 以 利用 前 者 ， 保 存 数据 、 停 
止 播放 动画 和 视频 等 ， 利 用 后 者 ， 读 取保 存 的 数据 、 重 新 播放 动画 和 视频 等 。 

实现 方式 如 下 : 


/增加 当前 屏幕 进入 和 暂停 状态 的 事件 函数 
@Override 


protected void onPause() { 
super.onPause(); 
Log.i(LOG TAG "Form "+ formName + " got onPause"); 
for (OnPauseListener onPauseListener : onPauseListeners) { 
onPauseListener.onPause(); 


} 


ScreenPause(); 


@SimpleEvent(description = "当前 屏幕 进入 暂停 状态 ") 
public void ScreenPause() { 
EventDispatcher.dispatchEvent(this, "ScreenPause"); 


} 


// 增 加 当前 屏幕 进入 运行 状态 的 事件 函数 
@Override 
protected void onResume() { 


super.onResume(); 
Log.i(LOG TAG, "Form " + formName + " got onResume"); 
activeForm = this; 


// If applicationIsBeingClosed is true, call closeApplication() immediately to continue 
// unwinding through all forms of a multi-screen application. 
if (applicationIsBeingClosed) { 

closeApplication(); 


return; 


for (OnResumeListener onResumeListener : onResumeListeners) { 


onResumeListener.onResume(); 


ScreenResume(); 


} 
@SimpleEvent(description = "当前 屏幕 进行 运行 状态 ") 
public void ScreenResume() { 
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EventDispatcher.dispatchEvent(this, "ScreenResume"); 


} 
在 OdeMessages.java 中 添加 函数 的 声明 : 


@DefaultMessage("ScreenPause") 
@Description("") 
String ScreenPauseEvents(); 


@DefaultMessage("ScreenResume") 
@Description("") 
String ScreenResumeEvents(); 


在 OdeMessages_zh CN.properties 中 添加 中 文字 符 串 : 


ScreenPauseEvents = 屏幕 进入 暂停 状态 
ScreenResumeEvents = 屏幕 进入 运行 状态 


译 、 运 行 系统 后 ， 在 工作 面板 界面 ， 可 以 看 到 多 了 “屏幕 进入 暂停 状态 ”和 “屏幕 进 
入 运行 状态 ”两 个 事件 响应 函数 ， 如 图 7-8 所 示 。 


工作 面板 


Sa 


当 -屏幕 进入 暂停 状态 
执行 


当 .屏幕 进入 运行 状态 
nt @ 


图 7-8 新 增 事件 响应 函数 
使 用 这 两 个 函数 的 示例 代码 如 图 7-9 所 示 。 


当 .屏幕 进入 暂停 状态 
ad) RE ELD . Griz» 


当 .屏幕 进入 运行 状态 
Oy) 设置 ELD . EGAM 为 


图 7-9 代码 3 
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8 a 图 像 组 件 (Image) 的 定制 


8.1 ”增加 支持 的 动画 形式 


App Inventor 2 提供 的 图 像 组 件 只 支持 左右 滑动 的 动画 形式 ， 当 把 鼠标 移动 到 “动画 形 
式 ” 属 性 的 代码 块 上 时 ， 可 看 到 对 于 此 属性 的 说 明 ， 如 图 8-1 所 示 。 


À 


E EED CZAD» 


This is a limited form of animation that can attach a 
small number of motion types to images. The allowable 
motions are ScrollRightSlow, ScrollRight, ScrollRightFast, 
ScrollLeftSlow, ScrollLeft, ScrollLeftFast, and Stop 


i 


图 8-1 “动画 形式 ”属性 说 明 


现 修改 代码 使 其 也 支持 上 下 滑动 的 动画 形式 。 
图 像 组 件 的 源码 文件 为 Image.java， 其 中 有 如 下 代码 : 


I 


@SimpleProperty(description = "This is a limited form of animation that can attach " + 
"a small number of motion types to images. The allowable motions are " + 
"ScrollRightSlow, ScrollRight, ScrollRightFast, ScrollLeftSlow, ScrollLeft, " + 
"ScrollLeftFast, and Stop", 
category = PropertyCategory.APPEARANCE) 
// TODO(user): This should be changed from a property to an "animate" method, and have the choices 
// placed in a dropdown. Aternatively the whole thing should be removed and we should do 
// something that is more consistent with sprites. 
public void Animation(String animation) { 
AnimationUtil.Apply Animation(view, animation); 


} 


可 以 看 到 其 实 是 调用 AnimationUtil.ApplyAnimation 函数 实现 动画 ， 其 中 只 有 让 图 片 左 
滑动 的 代码 : 


public static void ApplyAnimation(View view, String animation) { 
// TODO(user): These string constants need to be extracted and defined somewhere else! 
// TODO(user): Also, the endless else-if is inefficient 
if (animation.equals("ScrollRightSlow")) { 
ApplyHorizontalScrollAnimation(view, false, 8000); 
} else if (animation.equals("ScrollRight")) { 
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ApplyHorizontalScrollAnimation(view, false, 4000); 
} else if (animation.equals("ScrollRightFast")) { 

ApplyHorizontalScrollAnimation(view, false, 1000); 
} else if (animation.equals("ScrollLeftSlow")) { 

ApplyHorizontalScrollAnimation(view, true, 8000); 
} else if (animation.equals("ScrollLeft")) { 

ApplyHorizontalScrollAnimation(view, true, 4000); 
} else if (animation.equals("ScrollLeftFast")) { 

ApplyHorizontalScrollAnimation(view, true, 1000); 
} else if (animation.equals("Stop")) { 


view.clearAnimation(); 


private static void ApplyHorizontalScrollAnimation(View view, boolean left, int speed) { 
float sign = left ? 1f: -1f; 
AnimationSet animationSet = new AnimationSet(true); 
animationSet.setRepeatCount(Animation. INFINITE); 
animationSet.setRepeatMode(Animation.RESTART); 


TranslateAnimation move = new TranslateAnimation(Animation.RELATIVE_TO PARENT, sign * 0.70f, 
Animation.RELATIVE TO PARENT, sign * -0.70f, Animation RELATIVE TO PARENT, 0, 
Animation.RELATIVE TO PARENT, 0); 

move.setStartOffset(0); 

move.setDuration(speed); 

move.setFillA fter(true); 

animationSet.addAnimation(move); 

view.startA nimation(animationSet); 


} 


参照 源码 添加 让 图 片上 下 滑动 的 代码 ， 首 先 修改 Imagejava 中 动画 形式 属性 的 说 明文 
字 ， 改 为 如 下 : 


description = "设置 图 片 左 右 或 上 下 滑动 ， 及 停止 滑动 ， 可 设置 的 值 为 : "+ 

"ScrollRightSlow. ScrollRight. ScrollRightFast. ScrollLeftSlow. ScrollLeft. "+ 
"ScrollLeftFast. ScrollDownSlow, ScrollDown, ScrollDownFast. ScrollUpSlow. ScrollUp, 
ScrollUpFast 和 Stop", 


然后 在 AnimationUtil java 中 添加 让 图 片上 下 滑动 的 代码 : 


public static void ApplyAnimation(View view, String animation) { 
// TODO (user): These string constants need to be extracted and defined somewhere else! 
// TODO(user): Also, the endless else-if is inefficient 
if (animation.equals("ScrollRightSlow")) { 
ApplyHorizontalScrollAnimation(view, false, 8000); 
} else if (animation.equals("ScrollRight")) { 
ApplyHorizontalScrollAnimation(view, false, 4000); 
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以 看 到 
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} else if (animation.equals("ScrollRightFast")) { 


ApplyHorizontalScrollAnimation(view, false, 1000); 


} else if (animation.equals("ScrollLeftSlow")) { 


ApplyHorizontalScrollAnimation(view, true, 8000); 


} else if (animation.equals("ScrollLeft")) { 


ApplyHorizontalScrollAnimation(view, true, 4000); 


} else if (animation.equals("ScrollLeftFast")) { 


ApplyHorizontalScrollAnimation(view, true, 1000); 


} else if (animation.equals("ScrollDownSlow")) { 
ApplyVerticalScrollAnimation(view, false, 8000); 
} else if (animation.equals("ScrollDown")) { 
ApplyVerticalScrollAnimation(view, false, 4000); 
} else if (animation.equals("ScrollDownFast")) { 


ApplyVerticalScrollAnimation(view, false, 1000); 


} else if (animation.equals("ScrollUpSlow")) { 


ApplyVerticalScrollAnimation(view, true, 8000); 


} else if (animation.equals("ScrollUp")) { 


Apply VerticalScrollAnimation(view, true, 4000); 


} else if (animation.equals("ScrollUpFast")) { 


ApplyVerticalScrollAnimation(view, true, 1000); 


} else if (animation.equals("Stop")) { 
view.clearAnimation(); 


} 


private static void ApplyVerticalScrollAnimation(View view, boolean up, int speed) { 


AnimationSet animationSet = new AnimationSet(true); 
animationSet.setRepeatCount(Animation. INFINITE); 
animationSet.setRepeatMode(Animation.RESTART); 


TranslateAnimation move; 


if (up) { 


move = new TranslateAnimation(Animation.RELATIVE TO SELF, 0.0f, 
Animation. RELATIVE_TO_SELF, 0.0f, Animation. RELATIVE_TO_SELF, 
1.0f, Animation. RELATIVE_TO_SELF, 0.0f); 


yelse { 


move = new TranslateAnimation(Animation.RELATIVE TO SELF, 0.0f, 
Animation. RELATIVE_TO_SELF, 0.0f, Animation. RELATIVE TO SELF, 
0.0f, Animation.RELATIVE TO_SELF, 1.0f); 


pe 


wR 


译 、 运 行 系统 后 ， 在 工作 面板 中 ， 
修改 后 的 说 明文 字 ， 如 图 8-2 所 示 。 


Ex 


鼠标 移动 到 “动画 


PI 


Wd 


$ 


EARE | 


上 上 时， 可 


RE ECD . BEA» 
设置 图 片 左右 或 上 下 滑动 ， 及 停止 滑动 ， 可 设置 的 值 为 : ScrollRightSlow、ScrollRight、ScrollRightFast、ScrollLeftSlow、ScrollLeft、 
ScrollLeftFast、ScrollDownSlow、ScrollDown、ScrollDownFast、ScrollUpSlow、ScrollUp、ScrollUpFast 和 Stop 


图 8-2 “动画 形式 ”属性 新 的 说 明 
使 用 这 个 属性 的 示例 代码 如 图 8-3 所 示 。 


当 .初始 化 
MT 28 CAD. 


图 8-3 ”代码 


8.2 ”增加 设置 动画 播放 次 数 和 时 间 的 功能 


App Inventor 2 默认 动画 是 无 限 循环 播放 ， 但 系统 自 带 的 代码 有 缺陷 ， 设 置 代 码 不 起 作 
用 ， 动 画 播放 只 会 播放 一 次 ， 需 要 修改 代码 。 修 改 如 下 : 


private static void ApplyHorizontalScrollAnimation(View view, boolean left, int speed) { 
float sign = left ? 1f: -1f; 
AnimationSet animationSet = new AnimationSet(true); 
// 原 有 设置 代码 
//animationSet.setRepeatCount(Animation.INFINITE); 
//animationSet.setRepeat Mode(Animation.RESTART); 


TranslateAnimation move = new TranslateAnimation(Animation.RELATIVE TO PARENT, sign * 
0.70f, 
Animation. RELATIVE_TO_PARENT, sign * -0.70f, Animation. RELATIVE TO PARENT, 0, 
Animation.RELATIVE TO PARENT, 0); 

move.setStartOffset(0); 

move.setDuration(speed); 

move.setFillA fter(true); 

/需要 在 此 设置 播放 次 数 和 模式 

move.setRepeatCount(Animation.INFINITE); 

move.setRepeatMode(Animation.RESTART); 

animationSet.addAnimation(move); 


view.startA nimation(animationSet); 


j 
修改 后 ， 动 画 可 无 限 循环 播放 ， 但 不 能 设置 播放 次 数 和 时 间 ， 不 够 灵活 。 
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现 增加 设置 播放 次 数 和 时 间 的 代码 ， 首 先 需 要 修改 Image.java 的 代码 ， 修 改 如 下 : 


/增加 两 个 变量 记录 播放 次 数 和 播放 时 间 


private int repeatCount = 0; 


private int duration = 0; 


/以 下 两 个 函数 是 播放 次 数 属 性 的 getter 和 setter 函数 ， 默 认 值 为 0， 此 时 用 系统 默认 的 播放 次 数 
@SimpleProperty(category = PropertyCategory.APPEARANCE, description = "设置 动画 播放 的 次 数 ") 
public int RepeatCount() { 


return repeatCount; 


} 


@DesignerProperty(editorType = PropertyTypeConstants.PROPERTY TYPE NON NEGATIVE INTEGER, 
defaultValue = "0") 

@SimpleProperty 

public void RepeatCount(int repeatCount) { 
this.repeatCount = repeatCount; 
/播放 次 数 的 值 传递 给 播放 动画 的 类 
AnimationUtil.ApplyAnimationRepeatCount(repeatCount); 


} 


/以 下 两 个 函数 是 播放 时 间 属 性 的 getter 和 setter 函数 ， 默 认 值 为 0， 此 时 用 系统 默认 的 播放 时 间 
@SimpleProperty(category = PropertyCategory. APPEARANCE, 

description = "设置 动画 播放 时 间 ， 单 位 是 毫秒 ") 
public int Duration() { 


return duration; 


@DesignerProperty(editorType = PropertyTypeConstants.PROPERTY TYPE NON NEGATIVE INTEGER, 
defaultValue = "0") 
@SimpleProperty 
public void Duration(int duration) { 
this.duration = duration; 
/播放 时 间 的 值 传递 给 播放 动画 的 类 
AnimationUtil.ApplyAnimationDuration(duration); 


} 


AnimationUtiljava 的 代码 修改 如 下 : 


48 


// 增 加 两 个 变量 记录 播放 次 数 和 播放 时 间 
private static int mRepeatCount = 0; 


private static int mDuration = 0; 


// 增 加 两 个 变量 的 setter 函数 ， 供 Image 类 调用 
public static void ApplyAnimationRepeatCount(int repeatCount) { 


mRepeatCount = repeatCount; 


public static void ApplyAnimationDuration(int duration) { 
mDuration = duration; 


private static void ApplyHorizontalScrollAnimation(View view, boolean left, int speed) { 
float sign = left ? 1f: -1f; 
AnimationSet animationSet = new AnimationSet(true); 
//animationSet.setRepeatCount(Animation. INFINITE); 
//animationSet.setRepeatMode(Animation.RESTART); 


TranslateAnimation move = new TranslateAnimation(Animation.RELATIVE TO PARENT, sign*0.70f, 
Animation.RELATIVE TO PARENT, sign * -0.70f, Animation.RELATIVE_TO PARENT, 0, 
Animation.RELATIVE TO PARENT, 0); 

move.setStartOffset(0); 


// 值 为 0 时 用 系统 默认 的 播放 时 间 

if (mDuration == 0){ 
move.setDuration(speed); 

} else { 
move.setDuration(mDuration); 


move.setFillA fter(true); 


/ 值 为 0 时 用 系统 默认 的 播放 次 数 
if (mRepeatCount == 0) { 
move.setRepeatCount(Animation.INFINITE); 
} else { 
move.setRepeatCount(mRepeatCount); 


move.setRepeatMode(Animation.RESTART); 
animationSet.addAnimation(move); 


view.startA nimation(animationSet); 

private static void ApplyVerticalScrollAnimation(View view, boolean up, int speed) { 
AnimationSet animationSet = new AnimationSet(true); 
//animationSet.setRepeatCount(Animation. INFINITE); 


//animationSet.setRepeatMode(Animation.RESTART); 


TranslateAnimation move; 


if (up){ 
move = new TranslateAnimation(Animation.RELATIVE TO SELF, 0.0f, 
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Animation.RELATIVE_TO_SELF, 0.0f Animation. RELATIVE TO SELF, 
1.0f, Animation. RELATIVE_TO SELF, 0.0f); 
yelse { 


move = new TranslateAnimation(Animation.RELATIVE _TO_SELF, 0.0f, 
Animation. RELATIVE_TO_SELF, 0.0f, Animation. RELATIVE TO SELF, 
0.0f, Animation.RELATIVE TO_SELF, 1.0f); 
j 
move.setStartOffset(0); 


if (mDuration == 0) { 
move.setDuration(speed); 


yelse { 


move.setDuration(mDuration); 
j 


move.setFillAfter(true); 


if (mRepeatCount == 0) { 
move.setRepeatCount(Animation.INFINITE); 
} else { 


move.setRepeatCount(mRepeatCount); 
j 


move.setRepeatMode(Animation.RESTART); 
animationSet.addAnimation(move); 


view.startA nimation(animationSet); 
j 


属性 的 声明 : 


@DefaultMessage("RepeatCount") 
@Description("") 


在 OdeMessages.java 中 添加 


String RepeatCountProperties(); 
@DefaultMessage("Duration") 
@Description("") 
String DurationProperties(); 
在 OdeMessages zh CN.properties 中 添加 属性 的 中 


RepeatCountProperties = 动画 播放 次 数 
DurationProperties = 动画 播放 办 


| 


X 
yy 
Ud 


| 间 


编译 、 运 行 系统 后 ， 在 组 件 
数 ”两 个 属性 ， 默 认 值 都 是 0， 如 
在 工作 面板 


FP， 也 可 以 看 到 夫 


Va 


me PR Al 


= 中， 可 以 看 到 多 了 “动画 播放 时 间 ” 和 “动画 播放 
8-4 所 示 。 
MJ 
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“动画 播放 时 间 ” 和 “动画 播放 次 数 ” 


两 个 属性 


m4 
H 
my 
aT 


getter 和 setter 函数 ， 如 图 8-5 所 示 。 


组 件 属性 工作 面板 
图 像 1 z mam 
sia COD CHLORE 
动画 播放 时 间 ( 毫 秒 ) - - — 
‘ RE EVR ~ 赔 动 男 播放 时 间 > 有 Ba 
高 度 
自动 .… 
宽度 
自动 设置 为 
图 片 
动画 播放 次 数 设置 . 为 
0 
旋转 角度 
a 设置 
图 8-4 新 增 属性 图 8-5 “新 增 属性 函数 


8.3 ”增加 单 击 事件 响应 函数 


Android 系统 的 图 像 显 示 控件 是 可 以 响应 用 户 单 击 事 件 的 ， 但 App Inventor 2 提供 的 图 像 
组 件 不 支持 此 功能 ， 使 用 多 有 不 便 ， 现 增加 此 功能 ， 具 体 增加 的 代码 如 下 : 


import com.google.appinventor.components.annotations.SimpleEvent; 
import android.view. View.OnClickListener; 


/Image 类 增加 对 OnClickListener 接口 的 继承 
public final class Image extends AndroidViewComponent implements OnClickListener { 


/构造 函数 中 注册 监听 单 击 事件 函数 


public Image(ComponentContainer container) { 


super(container); 


view.setOnClickListener(this); 


} 


// 重 写 从 OnClickListener 接口 继承 的 函数 
@Override 
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public void onClick(View view) { 
ClickQ; 
} 


@SimpleEvent(description = "用 户 单 击 图 片 事 件 的 响应 函数 ") 
public void Click() { 
EventDispatcher.dispatchEvent(this, "Click"); 
} 
} 


App Inventor 2 的 源码 中 已 经 在 OdeMessages.java 中 添加 了 Click 函数 的 声明 ， 在 
OdeMessages_zh_CN.properties 中 添加 了 Click 函数 的 中 文字 符 串 ， 因 此 无 须 修 改 这 两 个 文件 
编译 、 运 行 系统 后 ， 在 工作 面板 中 ， 可 以 看 到 增加 了 一 个 新 函数 ， 如 图 8-6 所 示 。 


工作 面板 


o 


3 GEID .被 单 击 


图 8-6 rt 


i% 
Ml 
T 


事件 响应 函数 
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第 9 音 bree (Label) 的 定制 


标签 组 件 对 应 的 是 Android 系统 的 TextView 控件 ，App Inventor 2 默认 只 用 于 显示 文 
本 ， 但 也 可 以 扩展 支持 显示 图 片 ， 源 码 文件 为 Labeljava。 


9.1 增加 允许 单行 或 多 行 显示 的 属性 


App Inventor 2 的 标签 组 件 默认 文 持 文本 长 度 大 于 组 件 长 度 时 为 多 行 显示 ， 但 有 时 从 
界面 设计 方面 考虑 ， 不 能 多 行 显示 ， 只 能 单行 显示 ; 在 单行 显示 的 时 候 ， 如 果 文 本 长 度 
大 于 组 件 长 度 ， 为 了 使 用 户 能 看 到 所 有 的 文本 ， 还 需要 支持 文本 的 水 平 滚 动 ， 具 体 实 现 
方式 如 下 。 

在 Labeljava 中 增加 如 下 代码 : 


// 增 加 变量 标识 单行 或 多 行 显示 


private boolean multiLine; 


@SimpleProperty( category = PropertyCategory.BEHAVIOR, description = "允许 多 行 ") 
public boolean MultiLine() { 


return multiLine; 


@DesignerProperty(editorType=Property TypeConstants.PROPERTY TYPE BOOLEAN, defaultValue="True") 
@SimpleProperty 
public void MultiLine(boolean multiLine) { 

this.multiLine = multiLine; 

TextViewUtil.setSingleLine(view, !multiLine); 


} 


在 TextViewUtil java 中 增加 如 下 代码 : 


public static void setSingleLine(TextView textview, boolean enabled) { 
textview.setSingleLine(enabled); 
if (enabled) { 
/在 单行 显示 时 ， 设 置 文 持 水 平 滚动 文本 


textview.setHorizontallyScrolling(enabled); 
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因 


为 增加 


增加 属 怕 


java ! 


的 属性 函数 名 称 
E 的 声明 和 在 OdeMessages zh CN.properties 4 


与 文本 框 


的 属性 函数 名 称 一 


9.2 ”增加 人 允许 被 选中 复制 的 属性 


此 
在 Label.java : 


在 TextViewUtil java + 


在 OdeMessages.java 中 添加 


在 OdeMessages_zh_CN.properties 4 


9.3 ”增加 单 击 事件 响应 


月 


属性 功能 支 


// 增 加 变量 标识 标签 文 


寺 用 户 复 种 
增加 如 下 代码 : 


本 是 否 允 许 被 选中 复 


private boolean textIsSelectable; 


@SimpleProperty( 


A 


i 


as 


category = PropertyCategory. BEHAVIOR, 


"i 


description 


标签 文本 是 否 可 被 选中 复制 ") 


public boolean TextIsSe 


lectable() { 


return textIsSelectable; 


样 ， 


改 不 需要 在 OdeMessages. 


添加 ， 


LFA R, 


文子 付 


| 炸 贴 标签 组 件 的 文本 到 其 他 地 方 ， 有 具体 实现 方式 如 下 。 


@DesignerProperty(editorType = PropertyTypeConstants.PROPERTY TYPE BOOLEAN, defaultValue = 


"False") 
@SimpleProperty 


public void TextIsSelectable(boolean textIsSelectable) { 
this.textIsSelectable = textIsSelectable; 
TextViewUtil.setTextIsSelectable(view, textIsSelectable); 


} 


P 增 加 如 下 代码 : 


public static void setTextIsSelectable(TextView textview, boolean enabled) { 
textview.setTextIsSelectable(enabled); 


} 


@DefaultMessage("TextIsSelectable") 


@Description("") 
String TextIsSelectableP. 


TextIsSelectableProperti 


roperties(); 


数 


添加 ， 
es= 允许 被 选中 复 


属性 的 声明 


AB 


rfl) 
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H TextView 响应 用 户 单 


击 事 


开发 应 用 常会 


所 到 的 功能 ， 但 App Inventor 2 提供 的 


标签 组 件 不 支持 此 功能 ， 现 增加 此 功能 ， 具 体 实现 方式 如 下 。 
在 Label.java 中 增加 如 下 代码 : 


import android.view. View.OnClickListener; 


/Label 类 增加 对 OnClickListener 接口 的 继承 
public final class Label extends AndroidViewComponent implements OnClickListener { 
// 构 造 函 数 中 注册 监听 单 击 事件 函数 


public Label(ComponentContainer container) { 


super(container); 
view = new TextView(container.$context()); 


view.setOnClickListener(this); 


/ 重 写 从 OnClickListener 接口 继承 的 函数 
@Override 
public void onClick( View view) { 

Click); 


} 
@SimpleEvent(description = "用 户 单 击 标签 事件 的 响应 函数 ") 


public void Click() { 
EventDispatcher.dispatchEvent(this, "Click"); 


} 


为 增加 的 函数 名 称 与 其 他 组 件 的 函数 名 称 一 样 ， 故 不 需要 在 OdeMessages.java ! 


函数 的 声明 和 在 OdeMessages_zh_CN.properties 中 添加 中 文字 符 串 。 


H 


9.4 ”增加 跑马 灯 效 果 函 数 


此 函数 用 于 设置 从 右 向 左 无 限 循环 滚动 标签 文本 ， 具 体 实 现 方式 如 下 。 
在 Labeljava 中 增加 如 下 代码 : 


import android.text. TextUtils; 


@SimpleFunction(description = "跑马 灯 效 果 ") 
public void Marquee() { 
TextViewUtil.setMarquee(view); 


} 


在 TextViewUtil java 中 增加 如 下 代码 : 


public static void setMarquee(TextView textview) { 


JS 


setSingleLine(textview, true); 
setTextIsSelectable(textview, true); 
textview.setEllipsize(TextUtils. TruncateAt. MARQUEE); 
textview.setMarqueeRepeatLimit(-1); 


} 
在 OdeMessages.java 中 添加 函数 的 声明 : 


@DefaultMessage("Marquee") 
@Description("") 
String MarqueeMethods(); 


在 OdeMessages zh CN.properties 中 添加 中 文字 符 串 : 


MarqueeMethods = 跑马 灯 效 果 


9.5 ”增加 设置 标签 图 片 的 函数 


此 函数 用 于 设置 在 标签 的 上 下 左右 四 边 显 示 的 图 片 ， 具 体 实 现 方式 如 下 。 
在 Label.java 中 增加 如 下 代码 : 


@SimpleFunction(description = "设置 在 标签 的 上 下 左右 四 边 显 示 的 图 片 ") 
public void SetLabelDrawable(String path, int width, int height, boolean left, boolean top, boolean right, 


boolean bottom) { 
Drawable drawable = null; 
Drawable drawableLeft = null; 
Drawable drawableTop = null; 
Drawable drawableRight = null; 
Drawable drawableBottom = null; 


String picturePath = (path == null) ? "" : path; 


try { 

drawable = MediaUtil.getBitmapDrawable(container.$form(), picturePath); 
} catch (IOException ioe) { 

Log.e("Label", "Unable to load " + picturePath); 


drawable = null; 
if (drawable != null) { 
int correctedWidth = (int)(width * container. $form().deviceDensity()); 


int correctedHeight = (int)(height * container.$form().deviceDensity()); 
drawable.setBounds(0, 0, correctedWidth, correctedHeight); 
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} 


在 Drawerjs 文件 的 component method 数组 中 ， 增 加 如 下 代码 ， 设 置 上 述 隐 3 
数 的 默认 值 : 


if (Jeft){ 
drawableLeft = drawable; 


if (top) { 
drawableTop = drawable; 


if (right) { 
drawableRight = drawable; 


if (bottom) { 
drawableBottom = drawable; 


view.setCompoundDrawables(drawableLeft, drawableTop, drawableRight, drawableBottom); 
view.requestLayout(); 


} 


we 
> 
F 
es 
Y 


{matchingMutatorAttributes: {component_type:"Label", method_name:"SetLabelDrawable"}, 


<value . 


..</value> 这 个 字段 描述 了 对 哪个 参数 赋值 ， 及 默认 值 的 类 型 和 值 。 
用 这 种 方式 ，App Inventor 2 实现 了 给 函数 的 参数 赋予 默认 值 。 


mutatorXMLStringFunction: function(mutatorAttributes) { 
return " + 

'<xml>' + 
<block type="component_method">' + 
//mutator generator 
Blockly. Drawer.mutatorA ttributesToXMLString(mutatorAttributes) + 
‘<value name="ARG3"><block type="logic_boolean"><title name="BOOL">TRUE<X<‘/title> 
</block></value>' + 
‘<value name="ARG4"><block type="logic_boolean"><title name="BOOL">FALSE</title> 
</block></value>' + 
‘<value name="ARGS5"><block type="logic_boolean"><title name="BOOL">FALSE</title> 
</block></value>' + 
‘<value name="ARG6"><block type="logic_boolean"><title name="BOOL">FALSE</title> 
</block></value>' + 
‘</block>' + 


'</xml>';}}, 


在 OdeMessages.java 中 添加 函数 的 声明 : 
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@DefaultMessage("SetLabelDrawable") 


@Description("") 


String SetLabelDrawableMethods(); 


在 OdeMessages zh CN.properties 4 


SetLabelDrawableMethods = 设置 标签 的 图 


9.6 ”增加 语文 本 处 理 函 数 


富 文本 可 以 对 选中 的 部 分 文字 


添加 


F 


单独 设置 : 


字体 、 字 号 和 颜色 等 ， 也 可 以 在 文本 中 添加 图 


片 。 在 App Inventor 2 中 ， 如 果 要 用 标签 组 件 实现 富 文 本 的 这 些 功能 ， 


格式 处 理 ， 但 这 样 就 得 了 解 HTML f 


Android 系统 提供 了 用 于 处 理 富 文 本 的 类 SpannableString， 可 以 
合 ， 实 现 标签 组 件 支持 富 文本 的 功能 ， 且 不 需要 具 


地 使 用 。 
在 Label.java 中 增加 如 下 代码 : 


的 知识 ， 使 用 起 来 不 方便 。 


iz 


需要 把 文本 按 HTML 


备 HTML 的 知识 ， 


import com.google.appinventor.components.annotations.SimpleF unction; 


import com.google.appinventor.components.annotations.SimpleEvent; 


import com.google.appinventor.components.runtime.util. MediaUtil; 


import android.graphics.drawable.Drawable; 


import android.graphics. Typeface; 


import android.text.SpannableString; 


import android.text.Spanned; 
import android.text.TextPaint; 


import android.text.method.LinkMovementMethod; 
import android.text.style.BackgroundColorSpan; 

import android.text.style.ClickableSpan; 
import android.text.style.ForegroundColorSpan; 


import android.text.style.ImageSpan; 


import android.text.style.RelativeSizeSpan; 
import android.text.style.StrikethroughSpan; 


import android.text.style.StyleSpan; 
import android.text.style.SubscriptSpan; 


import android.text.style.SuperscriptSpan; 


import android.text.style: URLSpan; 


import android.text.style. UnderlineSpan; 


import android.text.style.AbsoluteSizeSpan; 


import java.io. IOException; 


/增加 SpannableString 的 变量 
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j 这 个 类 与 其 他 类 结 
发 人 员 可 以 很 方便 


private SpannableString spannableString; 


/增加 图 片 路 径 的 变量 
private String picturePath 


=, 
? 


@SimpleFunction(description = "创建 富 文 本 ") 
public void CreateSpannableString(String text) { 
spannableString = new SpannableString(text); 


@SimpleFunction(description = "设置 富 文 本 的 前 景色 ") 
public void SetForegroundColor(int color, int startIndex, int endIndex) { 


ForegroundColorSpan foregroundColorSpan = new ForegroundColorSpan(color); 
spannableString.setSpan(foregroundColorSpan, startIndex, endIndex, Spanned.SPAN INCLUSIVE _ 
EXCLUSIVE); 


@SimpleFunction(description = "设置 富 文 本 的 背景 色 ") 
public void SetBackgroundColor(int color, int startIndex, int endIndex) { 


BackgroundColorSpan backgroundColorSpan = new BackgroundColorSpan(color); 
spannableString.setSpan(backgroundColorSpan, startIndex, endIndex, Spanned.SPAN INCLUSIVE _ 
EXCLUSIVE); 


@SimpleFunction(description = "设置 富 文 本 文字 的 字号 ") 

public void SetAbsoluteSize(int size, int startIndex, int endIndex) { 
AbsoluteSizeSpan absoluteSizeSpan = new AbsoluteSizeSpan(size, true); 
spannableString.setSpan(absoluteSizeSpan, startIndex, endIndex, Spanned.SPAN INCLUSIVE _ 
EXCLUSIVE); 


@SimpleFunction(description = "设置 富 文 本 文字 的 字体 为 粗 体 ") 
public void SetStyleBold(int startIndex, int endIndex) { 
StyleSpan styleSpan = new StyleSpan(Typeface.BOLD); 
spannableString.setSpan(styleSpan, startIndex, endIndex, Spanned.SPAN INCLUSIVE EXCLUSIVE); 


@SimpleFunction(description = "设置 富 文 本 文字 的 删除 线 ") 

public void SetStrikethrough(int startIndex, int endIndex) { 
StrikethroughSpan strikethroughSpan = new StrikethroughSpan(); 
spannableString.setSpan(strikethroughSpan, startIndex, endIndex, Spanned.SPAN INCLUSIVE _ 
EXCLUSIVE); 


@SimpleFunction(description = "设置 富 文 本 文字 的 下 划 线 ") 
public void SetUnderline(int startIndex, int endIndex) { 
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UnderlineSpan underlineSpan = new UnderlineSpan(); 
spannableString.setSpan(underlineSpan, startIndex, endIndex, Spanned.SPAN INCLUSIVE EXCLUSIVE); 


@SimpleFunction(description = "设置 富 文 本 文字 的 上 标 ") 
public void SetSuperscript(int startIndex, int endIndex) { 


SuperscriptSpan superscriptSpan = new SuperscriptSpan(); 
spannableString.setSpan(superscriptSpan, startIndex, endIndex, Spanned.SPAN INCLUSIVE 
EXCLUSIVE); 


@SimpleFunction(description = "设置 富 文 本 文字 的 下 标 ") 
public void SetSubscript(int startIndex, int endIndex) { 
SubscriptSpan subscriptSpan = new SubscriptSpan(); 
spannableString.setSpan(subscriptSpan, startIndex, endIndex, Spanned.SPAN INCLUSIVE_ EXCLUSIVE); 


} 
@SimpleFunction(description = "设置 富 文本 文字 的 超级 链接 ， 行 为 参数 的 值 为 打 电 话 、 发 短信 、 
打开 网 页 
public void SetURL(String action, String text, int startIndex, int endIndex) { 
URLSpan urlSpan; 


这 (action.equals(" 打 电话 ") { 
urlSpan = new URLSpan("tel:" + text); 
spannableString.setSpan(urlSpan, startIndex, endIndex, Spanned.SPAN INCLUSIVE EXCLUSIVE); 
view.setMovementMethod(LinkMovementMethod.getInstance()); 


} 


让 (action.equals(" 发 短信 ")) { 
urlSpan = new URLSpan("smsto:" + text); 
spannableString.setSpan(urlSpan, startIndex, endIndex, Spanned.SPAN INCLUSIVE EXCLUSIVE); 
view.setMovementMethod(LinkMovementMethod.getInstance()); 


} 


f(action.equals(" 打 开 网 页 ")) { 
urlSpan = new URLSpan(text); 
spannableString.setSpan(urlSpan, startIndex, endIndex, Spanned.SPAN INCLUSIVE EXCLUSIVE); 
view.setMovementMethod(LinkMovementMethod.getInstance()); 


} 


@SimpleFunction(description =" 富 文本 中 插入 图 片 ，width 和 height 是 图 片 显 示 区 域 的 宽度 和 高 度 ") 
public void SetImage(String path, int width, int height, int startIndex, int endIndex) { 
picturePath = (path == null) ? "" : path; 


Drawable drawable; 


try { 
drawable = MediaUtil.getBitmapDrawable(container.$form(), picturePath); 


} catch (IOException ioe) { 
Log.e("Image", "Unable to load " + picturePath); 
drawable = null; 


int correctedWidth = (int)(width * container.$form().deviceDensity()); 
int correctedHeight = (int)(height * container.$form().deviceDensity()); 


drawable.setBounds(0, 0, correctedWidth, correctedHeight); 
ImageSpan imageSpan = new ImageSpan(drawable); 
spannableString.setSpan(imageSpan, startIndex, endIndex, Spanned.SPAN INCLUSIVE EXCLUSIVE); 


@SimpleFunction(description = "设置 富 文 本 为 标签 内 容 ") 
public void SetSpannableString() { 


view.setText(spannableString); 
view.requestLayout(); 


} 
在 OdeMessages.java 中 添加 函数 和 参数 的 声明 : 


@DefaultMessage("CreateSpannableString") 
@Description("") 
String CreateSpannableStringMethods(); 


@DefaultMessage("SetForegroundColor") 
@Description("") 
String SetForegroundColorMethods(); 


@DefaultMessage("SetBackgroundColor") 
@Description("") 
String SetBackgroundColorMethods(); 


@DefaultMessage("SetAbsoluteSize") 
@Description("") 
String SetAbsoluteSizeMethods(); 


@DefaultMessage("SetStyleBold ") 
@Description("") 


String SetStyleBoldMethods(); 


@DefaultMessage("SetStrikethrough") 
@Description("") 
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String SetStrikethroughMethods(); 


@DefaultMessage(""SetUnderline") 
@Description("") 
String SetUnderlineMethods(); 


@DefaultMessage("SetSuperscript") 
@Description("") 
String SetSuperscriptMethods(); 


@DefaultMessage("SetSubscript") 
@Description("") 
String SetSubscriptMethods(); 


@DefaultMessage("SetURL") 
@Description("") 
String SetURLMethods(); 


@DefaultMessage("SetImage") 
@Description("") 
String SetImageMethods(); 


@DefaultMessage("SetSpannableString") 
@Description("") 
String SetSpannableStringMethods(); 


@DefaultMessage("startIndex") 
@Description("") 

String startIndexParams(); 
@DefaultMessage("endIndex") 
@Description("") 

String endIndexParams(); 


@DefaultMessage("size" 
@Description("") 


String sizeParams(); 


@DefaultMessage("action") 
@Description("") 
String actionParams(); 


在 OdeMessages zh CN.properties 中 添加 函数 和 参数 的 中 文字 符 串 : 


CreateSpannableStringMethods = 创建 富 文本 
SetForegroundColorMethods = 设置 语文 本 的 前 景色 


SetBackgroundColorMethods = 设置 语文 本 的 背景 色 
SetAbsoluteSizeMethods = 设置 富 文本 文字 的 字号 
SetStyleBoldMethods = 设置 富 文本 文字 的 字体 为 粗 体 
SetStrikethroughMethods = 设置 富 文本 文字 的 删除 线 
SetUnderlineMethods = 设置 富 文本 文字 的 下 划 线 
SetSuperscriptMethods = 设置 富 文本 文字 的 上 标 
SetSubscriptMethods = 设置 富 文本 文字 的 下 标 
SetURLMethods = 设置 富 文本 文字 的 超级 链接 
SetImageMethods = 富 文 本 中 插入 图 片 
SetSpannableStringMethods = 设置 富 文本 为 标签 内 容 


startIndexParams = 开始 字符 的 索引 值 
endIndexParams = 结束 字符 的 索引 值 
sizeParams = 字号 

actionParams = 行为 


9.7 ”实现 结果 


或 


该 译 、 运 行 系统 后 ， 在 组 件 属性 中 ， 可 以 看 到 增加 了 “允许 多 行 ” 和 “人 允许 被 选中 复 
制 ” 两 个 属性 ， 如 图 9-1 所 示 。 
工作 面板 中 ， 增 加 了 这 两 个 属性 的 getter 和 setter 函数 ， 如 图 9-2 所 示 。 


宽度 工作 面板 
允许 多 行 z = 

reas 设置 GAD . CEE 为 
文本 
=e 设置 GHD . 62 
居 左 :0 > 


文本 颜色 
E ze 


允许 被 选中 复制 


图 9-1 新 增 属性 图 9-2 新 增 属性 函数 


在 工作 面板 中 ， 还 可 以 看 到 其 余 新 增 事件 响应 函数 和 功能 函数 ， 如 图 9-3 一 图 9-6 
所 示 。 


/ 
du. 
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AD .创建 富 文本 


DED .跑马 灯 效 果 


开始 字符 的 索引 值 
结束 字符 的 索引 值 


图 9-3 ”新 增 函 数 1 


调用 CEID .设置 标签 的 图 片 
路 径 
宽度 
高 度 


调用 CE .设置 语文 本 为 标签 内 容 


调用 CEI .设置 语文 本 文字 的 删除 线 
开始 字符 的 索引 值 
结束 字符 的 索引 值 


调用 CEID .设置 语文 本 文字 的 字体 为 粗 体 
开始 字符 的 索引 值 
结束 字符 的 索引 值 


图 9-5 新 增 函 数 3 


9.8 ”使 用 示例 


调用 CAD .设置 富 文本 的 背景 色 
颜色 

开始 字符 的 索引 值 

结束 字符 的 索引 值 


调用 CAD .设置 语文 本 的 前 景色 
颜色 

开始 字符 的 索引 值 

结束 字符 的 索引 值 


调用 CEID .语文 本 中 插入 图 片 
路 径 
宽度 
高 度 

开始 字符 的 索引 值 
结束 字符 的 索引 值 


调用 GED .设置 语文 本 文字 的 下 标 
开始 字符 的 索引 值 
结束 字符 的 索引 值 


调用 CAD .设置 语文 本 文字 的 上 标 
开始 字符 的 索引 值 
结束 字符 的 索引 值 


调用 CEID .设置 语文 本 文字 的 超级 链接 
行为 

文本 

开始 字符 的 索引 值 

结束 字符 的 索引 值 


调用 CAD .设置 语文 本 文字 的 下 划 线 
开始 字符 的 索引 值 
结束 字符 的 索引 值 


图 9-6 新 增 函 数 4 


1) 设置 标签 的 图 片 、 标 签 文本 跑马 灯 效 果 和 标签 文本 可 被 选中 复制 的 代码 如 图 9-7 


所 示 。 
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当 .初始 化 
执 得 上 设置 GED . EZI 为 
| 调用 GAD . 设 置 标签 的 图 片 
路 径 | “ 
宽度 | 
高 度 


left 


top 

right 

bottom 

Ei Ire- 页 文本 E 
| 调用 AD .跑马 灯 效果 

| 设置 ER EDY i, 


图 9-7 代码 1 
实现 的 效果 如 图 9-8 和 图 9-9 所 示 。 


Screenl 


S 


区 热烈 欢迎 B| 
© 
:从 右 向 左 滚动 显示 此 标签 使 用 了 中 


此 标签 文本 可 被 选中 复制 粘贴 


图 9-8 效果 1 
注 : 图 中 显示 的 “标签 2” 组 件 的 文本 正在 从 右 向 左 滚动 显示 。 


4 1:32 


S| 热烈 欢迎 e 
此 标签 使 用 了 跑马 灯 效 果 ， 标 签 文本 无 限 循环 从 右 
图 ”此 标签 文本 可 被 选中 国 章 粘 巾 


图 9-9 效果 2 
注 ， 图 中 显示 的 “标签 3” 组 件 的 文本 已 被 选中 复制 。 
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td 


式 如 
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设置 标签 的 图 片 时 ， 需 要 首先 在 工程 中 添加 图 片 素材 ， 如 图 9-10 所 示 。 
2) Android 系统 提供 了 RadioButton 控件 〈 单 选 按钮 )， 常 用 于 从 多 个 选项 中 选择 
实现 效果 如 图 9-11 所 示 。 


素材 


Al2Compa.…-lcon.png 


Ae 


@) aist O 货 到 付款 


图 9-10 素材 1 图 9-11 Android 系统 的 单 选 按钮 


App Inventor 2 没有 提供 类 似 的 组 件 ， 但 可 以 利用 标签 组 件 实现 同样 效果 ， 有 具体 实现 方 
下 : 
在 工程 中 添加 两 张 图 片 素材 ， 如 图 9-12 所 示 。 
在 界面 中 添加 两 个 标签 组 件 ， 按 图 9-13 所 示 布 局 和 设置 标签 文本 。 
Mo ees 
bin radi. off ong 线 上 支付 。 货 到 付款 


btn_radio_on.png 


图 9-12 素材 2 图 9-13 标签 布局 
具体 实现 代码 如 图 9-14 一 图 9-17 所 示 。 


初始 化 全 局 变量 EIST» (ER 


图 9-14 代码 2 


= .初始 化 


HT 调用 EISUD .设置 标签 的 图 片 
‘yea um btn_radio_on.png B 
宽度 | 
高 度 
left | 】 
top | 
right | 
bottom | 
| 调用 ESE .设置 标签 的 图 片 
[btn_radio_off.png 县 
宽度 | 
高 度 
left | 


top | 


图 9-15 代码 3 


UE CEISTE » iB ~ | 

调用 EISD .设置 标签 的 图 片 
路 径 
宽度 
高 度 
left 
top 


right 
bottom 
OS .设置 标签 的 图 片 


right 

bottom 

调用 EELE .设置 标签 的 图 片 
路 径 

宽度 

高 度 


图 9-16 代码 4 
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路 径 
宽度 
高 度 
left 

top 
right 
bottom 


© .设置 标签 的 图 片 


图 9-17 代码 5 


实现 的 显示 效果 如 图 9-18 和 图 9-19 所 示 。 


OREZ © 货 到 付款 OREZ © REIMER 
图 9-18 效果 3 图 9-19 效果 4 


3) 设置 富 文本 的 颜色 、 字 号 、 下 划 线 、 删 除 线 和 字体 的 代码 如 图 9-20 所 示 。 


当 初始 化 
WT 调用 GAD .创建 富 文本 
文本 * CNEA" 
调用 CAD .设置 富 文本 的 背景 色 
颜色 上 
开始 字符 的 索引 值 | 
| 结束 字符 的 索引 值 
调用 CAD .设置 富 文 本 的 前 景色 
颜色 | 
开始 字符 的 索引 值 


结束 字符 的 索引 值 


调用 CSE 设置 富 文本 文字 的 宇 号 
字号 1 16) 
开始 字符 的 索引 值 | O 
| 结束 字符 的 索引 值 | 加 
A 标 等 1 本 FKTUA 
开始 字符 的 索引 值 | 加 
| 结束 字符 的 索引 值 | O 
调用 CAD .设置 富 文本 文字 的 删除 线 
开始 字符 的 索引 值 | 回 
| 结束 字符 的 索引 值 | ED 
调用 CES .设置 富 文本 文字 的 字体 为 粗 休 
开始 字符 的 索引 值 | E 
| 结束 字符 的 索引 值 | ED 
、 调 用 CAD .设置 语文 本 为 标签 内 容 


图 9-20 代码 6 


实现 的 显示 效果 如 图 9-21 所 示 。 
可 以 使 用 富 文 本 显示 多 种 样式 的 文本 
图 9-21 效果 5 
4) 设置 富 文 本 文字 的 上 下 标 功 能 ， 可 用 于 数学 计算 方面 。 示 例 代 码 如 图 9-22 所 示 。 
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x| 
设置 富 文本 文字 的 字号 
字号 

开始 字符 的 索引 值 
结束 字符 的 索引 值 
设置 富 文本 文字 的 下 标 
开始 字符 的 索引 值 
结束 字符 的 索引 值 
设置 富 文本 文字 的 上 标 
开始 字符 的 索引 值 
结束 字符 的 索引 值 
设置 富 文本 文字 的 字号 


开始 字符 的 索引 值 
结束 字符 的 索引 值 
设置 富 文本 文字 的 下 标 
开始 字符 的 索引 值 
结束 字符 的 索引 值 
设置 富 文本 文字 的 字号 


开始 字符 的 索引 值 
结束 字符 的 索引 值 
设置 富 文本 文字 的 字号 
字号 

开始 字符 的 索引 值 
结束 字符 的 索引 值 
设置 富 文本 文字 的 下 标 
开始 字符 的 索引 值 
结束 字符 的 索引 值 
设置 富 文本 文字 的 字号 
字号 

开始 字符 的 索引 值 
结束 字符 的 索引 值 
-设置 富 文本 文字 的 下 标 
开始 字符 的 索引 值 
结束 字符 的 索引 值 


加 .设置 富 文本 文字 的 上 标 


开始 字符 的 索引 值 
结束 字符 的 索引 值 


开始 字符 的 索引 值 
结束 字符 的 索引 值 
设置 语文 本 文字 的 字号 
字号 

开始 字符 的 索引 值 
结束 字符 的 索引 值 
设置 富 文本 为 标签 内 容 


图 9-22 代码 7 


实现 的 显示 效果 如 图 9-23 所 示 。 
5) 向 富 文 本 中 插入 图 片 时 ， 需 要 首先 在 工程 中 添加 图 片 素材 ， 如 图 9-24 所 示 。 


素材 
smiling1.png 
2 D_ smiling2.png 
X1 yi +X2Y2 =] 68 smiling3.png 
图 9-23 效果 6 图 9-24 素材 3 


具体 实现 代码 如 图 9-25 所 示 。 


当 .初始 化 
执行 ” 调用 CED .创建 富 文本 
文本 

调用 CEID . 富 文本 中 插入 图 片 
路 径 

宽度 

高 度 

开始 字符 的 索引 值 

结束 字符 的 索引 值 

调用 CEID .语文 本 中 插入 图 片 
路 径 

宽度 

高 度 

开始 字符 的 索引 值 

结束 字符 的 索引 值 

调用 GEID . 富 文本 中 插入 图 片 
路 径 

宽度 

高 度 

开始 字符 的 索引 值 

结束 字符 的 索引 值 

、 调 用 CEID .设置 襄 文 本 为 标签 内 容 


图 9-25 代码 8 


实现 的 显示 效果 如 图 9-26 所 示 。 


Oe SER 


在 需要 插入 图 片 的 地 方 ， 在 字符 串 中 都 4 
会 把 显示 的 字符 替代 掉 。 


图 9-26 效果 7 
CHE 


HAREE 


6) 设置 富 文本 文字 的 超级 链接 的 代码 如 图 9-27 所 示 。 


当 -初始 化 
| 执行 ” 调用 GED .创建 富 文本 


AA CAD 设置 语文 本 文字 的 超级 链接 


行为 
文本 


开始 字符 的 索引 值 
| 结束 字符 的 索引 值 
调用 CEID .设置 语文 本 文字 的 超级 链接 


行为 
文本 


开始 字符 的 索引 值 | 
结束 字符 的 索引 值 
WA CAD . 设 置 富 文本 为 标签 内 容 


片 ， 然 后 插入 图 片 的 时 候 ， 束 不 


E http://blog.csdn.net/xjbclz MW 


图 9-27 代码 9 
实现 的 显示 效果 如 网 9-28 所 示 。 
可 以 拨打 客服 电话 或 浏览 网 页 了 解 活动 详情 
图 9-28 效果 8 


单 击 “ 拨 打 客 服 电话 ”这 几 个 字 的 时 候 ， 


网 页 。 
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会 调用 拨号 程序 拨打 X X X X XX 这 个 号 
码 ; 单 击 “ 浏 览 网 页 ”这 几 个 字 的 时 候 ， 会 调用 浏 What] FA 


F http://blog.csdn.net/xjbelz 这 个 


第 10 章 ”列表 显示 框 (Listview ) 的 定制 


10.1 修改 显示 字符 串 


App Inventor 2 提供 的 列表 显示 框 ， 用 户 可 以 设置 是 否 在 其 上 显示 搜索 框 ， 但 搜索 框 
显示 的 提示 字符 串 为 英文 ， 可 修改 为 中 文 。 
列表 提示 框 的 源码 文件 是 ListView.java， 修 改 的 代码 如 下 : 


//txtSearchBox.setHint("Search list..."); 
txtSearchBox.setHint(" 搜 索 列 表 .."); 


单 击 列表 选择 框 时 ， 也 会 显示 列表 提示 框 ， 列 表 选 择 框 的 源码 文件 是 ListPickerjava， 
单 击 列 表 选 择 框 ， 调 用 ListPickerActivity 显示 列表 框 ， 修 改 ListPickerActivity.java 的 代码 
如 F: 


//txtSearchBox.setHint("Search list..."); 
txtSearchBox.setHint(" 搜 索 列 表 .…"); 


最 终 实 现 的 显示 效果 如 图 10-1 所 示 。 


图 10-1 中 文 显示 效果 


10.2 增加 显示 框 的 显示 样式 


Android 系统 还 提供 了 其 他 形式 的 列表 显示 框 ， 如 图 10-2 所 示 。 
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Action 


Adventure 


Animation 


Children 


Comedy 


Documentary 


Drama 


图 10-2 ”具有 单 选 按钮 的 列表 显示 框 1 


在 每 个 Item 的 最 右边 有 个 单 选 按钮 ， 想 要 实现 此 种 形式 的 单 选 按钮 ， 也 需要 修改 
ListView.java 的 代码 : 


// 标 识 是 否 使 用 具有 单 选 按 钮 的 列表 显示 框 ， 默 认为 false 


private boolean singleChoice = false; 


增加 设置 


和 获取 此 变量 值 的 函数 : 


@DesignerProperty(editorType = PropertyTypeConstants.PROPERTY TYPE BOOLEAN, 


defaultValue = "False") 


@SimpleProperty (description = "设置 是 否 显示 具有 单 选 按钮 的 列表 显示 框 )) 
public void SingleChoice(boolean singleChoice) { 


this.singleChoice = singleChoice; 


} 


@SimpleProperty(category = PropertyCategory. APPEARANCE, 


description = "返回 设置 单 选 按 钮 的 列表 显示 框 的 变量 数值 "") 


public boolean SingleChoice() { 


return singleChoice; 


} 
在 创建 列 


表 显 示 框 的 函数 中 ， 添 加 设置 列表 显示 框 样式 的 代码 : 


public void setAdapterData() { 
if (!singleChoice) { 


//App Invetor 2 默认 提供 的 列表 显示 框 
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adapter = new ArrayAdapter<Spannable>(container.$context(), android.R.layout.simple list_item 1, 
itemsToColoredText()); 


/创建 具有 单 选 按钮 的 列表 显示 框 ， 布 局 文件 和 上 面 不 同 
adapter=new Array Adapter<Spannable>(container.$context(), android.R.layout.simple_list_item_ 


single choice, 


itemsToColoredText()); 


Android BAU SHEE AA 


匡 中 的 多 选 ， 在 此 设置 为 单 选 模式 CHOICE MODE_SINGLE=1 
view.setChoiceMode(1); 
} 
view.setA dapter(adapter); 
if (!singleChoice) { 


list_item_1); 
}else{ 


adapterCopy = new ArrayAdapter<Spannable>(container.$context(), android.R.layout.simple_ 


list_ item_ single choice); 
} 


adapterCopy = new ArrayAdapter<Spannable>(container.$context(), android.R.layout.simple_ 


for (int i = 0; i < adapter.getCount(); ++i) { 


} 


adapterCopy.insert(adapter.getItem(i), 1); 


@DefaultMessage("SingleChoice") 
@Description("") 


在 OdeMessages.java 中 增加 


String SingleChoiceProperties(); 


在 OdeMessages_zh_CN.properties 中 增加 


SingleChoiceProperties 


PERS PSC 
显示 有 


了 单 选 按 钮 的 列表 显示 框 
编译 、 运 行 系统 后 ， 在 列表 显示 
按钮 的 列表 显示 框 ” 的 属 愧 


Ud 


R 框 的 组 件 属性 ! 


， 可 以 看 到 增加 了 一 个 “显示 3 
默认 为 不 显示 ， 如 图 10-3 所 示 。 


1? 


具有 单 选 
选中 颜色 
Ez 
显示 搜索 框 


显示 具有 单 选 按钮 的 列表 显示 框 
文本 颜色 


O 白色 


图 10-3 新 增 属 


型 
RE 
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FLV, tery bie Se T ER A 


工作 面板 


最 终 实 现 的 显示 效果 如 


图 10-5 


图 10-4 新 增 属性 函数 


图 10-5 所 示 。 


有 单 选 按 钮 的 列表 显示 让 


FE 的 getter 和 setter 函数 ， 如 图 


IHI 


10-4 所 示 。 


第 11 营 ”对 话 框 (Notifier) 的 定制 


11.1 修改 对 话 框 的 外 观 


系统 默认 创建 的 对 话 框 上 没有 图 标 ， 且 是 Android 系统 比较 古老 的 样式 ， 很 不 美观 ， 现 
修改 源码 增加 图 标 和 修改 对 话 框 的 样式 。 


11.1.1 增加 设置 图 标的 属性 
对 话 框 的 源码 文件 是 Notifierjava， 在 其 中 首先 增加 一 个 供用 户 设 置 是 否 显示 图 标的 


/增加 标识 是 否 显示 图 标的 变量 ， 默 认为 true 
private static boolean bIsDisplayIcon = true; 


在 创建 对 话 框 的 函数 中 ， 添 加 设置 图 标的 代码 : 


public static void oneButtonAlert(Activity activity, String message, String title, String buttonText) { 


if (bIsDisplayIcon){ 
alertDialog.setIcon(android.R.drawable.sym def app icon); 
} 


public static void twoButtonDialog(Activity activity, String message, String title, 
final string buttonl Text, final string button 2 Text, boolean cancelable, 
final Runnable positiveAction, final Runnable negativeAction, final Runnable cance(Action) { 


if (bIsDisplayIcon) { 
alertDialog.setIcon(android.R.drawable.sym_def_app_icon); 
} 


private void textInputDialog(String message, String title, boolean cancelable) { 
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if (bIsDisplayIcon) { 


alertDialog.setIcon(android.R.drawable.sym_def_app_icon); 
} 


} 


增加 设置 和 获取 属性 值 的 函数 : 


@SimpleProperty(description = "设置 对 话 框 是 否 显示 图 标 "， 
category = PropertyCategory.APPEARANCE) 
public boolean IsDisplayIcon() { 
return bIsDisplayIcon; 


@DesignerProperty(editorType = PropertyTypeConstants. PROPERTY TYPE BOOLEAN, 
defaultValue = "True") 


@SimpleProperty 

public void IsDisplayIcon(boolean bIsDisplaylcon) { 
bIsDisplayIcon = bIsDisplayIcon; 

} 


在 OdeMessages.java 中 增加 属性 声明 : 


@DefaultMessage("IsDisplayIcon") 
@Description("") 
String ISDisplayIconProperties(); 


在 OdeMessages_zh_CN.properties PIŠ JUR VEN FIC HF A 


Ez 
ay 


Ud 


IsDisplayIconProperties = 设置 对 话 框 是 否 显示 图 标 


编译 、 运 行 系 统 后 ， 在 对 话 框 的 组 件 属性 中 ， 可 以 看 到 增加 了 一 个 “设置 对 话 框 是 否 显 
示 图 标 ”的 属性 ， 上 默认 为 显示 ， 如 图 11-1 所 示 。 


组 件 属性 
对 话 框 1 
背景 颜色 
| 深交 


设置 对 话 框 是 否 显示 图 标 


图 11-1 新 增 属性 1 


在 工作 面板 中 ， 也 可 以 看 到 增加 了 此 属性 的 getter 和 setter 函数 ， 如 图 11-2 所 示 。 
78 


工作 面板 


调用 :显示 文本 对 话 框 
消息 


CHAD CER 


RE CLD CE Ea A 


图 11-2 新 增 属性 函数 1 
对 话 框 的 显示 效果 如 图 11-3 一 图 11-5 所 示 。 


es = 
ig! 提示 E 
消息 对 话 框 选择 对 话 框 
=~ 


图 11-3 显示 效果 1 


11-4 显示 效果 2 


ie! 提示 


文本 对 话 框 


图 11-5 显示 效果 3 


11.1.2 ”增加 修改 对 话 框 显示 风格 的 属性 


Google 推荐 Android App 的 显示 风格 是 Material Design 风格 ， 现 增加 一 个 可 设置 对 话 框 
显示 风格 为 Material Design 风格 的 属性 。 


/增加 标识 是 否 使 用 Material Design 风格 的 变量 ， 默 认为 false 
private static boolean bIsMaterialDesign = false; 


在 创建 对 话 框 的 函数 中 ， 添 加 设置 显示 风格 的 代码 : 
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public static void oneButtonAlert(Activity activity,String message, String title, String buttonText) { 
AlertDialog alertDialog = null; 


if (bIsMaterialDesign) { 
alertDialog = new AlertDialog.Builder(activity, android.R.style.Theme_Material Light Dialog 


Alert). create(); 
} else { 
alertDialog = new AlertDialog.Builder(activity).create(); 


public static void twoButtonDialog(Activity activity, String message, String title, 
final string button! Text, final string button2 Text, boolean cancelable, 
final Runnable positiveAction, final Runnable negativeAction, final Runnable cance(Action) { 
AlertDialog alertDialog = null; 


if (bIsMaterialDesign) { 
alertDialog = new AlertDialog.Builder(activity, android.R.style.Theme_Material Light Dialog 


Alert).create(); 
} else { 
alertDialog = new AlertDialog.Builder(activity).create(); 


} 


private void textInputDialog(String message, String title, boolean cancelable) { 
AlertDialog alertDialog = null; 


if (bIsMaterialDesign) { 
alertDialog = new AlertDialog.Builder(activity, android.R.style.Theme_ Material Light Dialog 


Alert).create(); 
} else { 
alertDialog = new AlertDialog.Builder(activity).create(); 


j 
增加 设置 和 获取 属性 值 的 函数 : 


FA 


@SimpleProperty(description = "设置 是 否 创建 Material Design 风格 的 对 话 
category = PropertyCategory.APPEARANCE) 
public boolean IsMaterialDesign() { 
return bIsMaterialDesign; 


ao 
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@DesignerProperty(editorType = PropertyTypeConstants.PROPERTY TYPE BOOLEAN, 
defaultValue = "False") 
@SimpleProperty 
public void IsMaterialDesign(boolean bIsMaterialDesign) { 
this.bIlsMaterialDesign = bIsMaterialDesign; 
j 


在 OdeMessages.java 中 增加 属性 声明 : 


@DefaultMessage("IsMaterialDesign") 
@Description("") 
String IsMaterialDesignProperties(); 


在 OdeMessages_zh CN.properties 中 增加 属性 的 中 文字 符 串 : 


IsMaterialDesignProperties = 设置 是 否 创建 Material Design 风格 的 对 话 村 


IHI 


编译 、 运 行 系统 后 ， 在 对 话 框 的 组 件 属性 中 ， 可 以 看 到 增加 了 一 个 “设置 是 否 创建 
Material Design 风格 的 对 话 框 ”的 属性 ， 默 认为 不 创建 ， 如 图 11-6 所 示 。 
组 件 属性 
对 话 框 1 
背景 颜色 
图 Rx 
设置 对 话 框 是 否 显示 图 标 
设置 是 否 创建 Material Design 风 格 


的 对 话 框 


图 11-6 新 增 属性 2 
在 工作 面板 中 ， 也 可 以 看 到 增加 了 此 属性 的 getter 和 setter 函数 ， 如 图 11-7 所 示 。 


工作 面板 


图 11-7 新 增 属性 函数 2 
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在 设置 创建 Material Design 风格 的 对 话 框 后 ， 对 话 框 的 显示 效果 如 图 11-8 一 图 11-10 
所 示 。 


@ 提示 @ 提示 
消息 对 话 杠 选择 对 话 框 


图 11-8 显示 效果 4 图 11-9 显示 效果 5 


@ 提示 
文本 对 话 框 


图 11-10 显示 效果 6 


11.2 ”增加 显示 函数 


对 话 框 组 件 默认 已 经 提供 了 几 个 函数 供用 户 使 用 ， 如 图 11-11 一 图 11-13 所 示 。 


调用 GHS Snes 
消息 调用 CHAD .显示 消息 对 话 框 
标题 消息 
按钮 文本 is 
标题 


按钮 2 文本 
按钮 文本 


图 11-11 原 有 “显示 选择 对 话 框 ”函数 图 11-12 原 有 “显示 消息 对 话 框 ”函数 


调用 ESD .显示 文本 对 话 框 
消息 


标题 
允许 撤销 OE. 


图 11-13 原 有 “显示 文本 对 话 框 ”函数 
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这 几 个 函数 都 需要 开发 人 员 输 入 多 个 参数 ， 使 用 不 方便 。 
通常 应 用 中 在 各 个 页 面 使 用 的 提示 框 、 标 题 和 按钮 文字 都 是 固定 的 ， 只 是 消息 内 容 有 变 
化 ， 故 可 增加 几 个 显示 对 话 框 的 函数 ， 实 现 和 上 述 函 数 同样 的 功能 ， 但 只 需 用 户 输入 消息 内 
容 ， 不 需要 输入 标题 和 按钮 文本 ， 减 少 开发 人 员 的 输入 ， 提 高 开发 效率 。 

在 Notifierjava 中 增加 以 下 代码 : 


— 


@SimpleFunction(description = "显示 提示 框 ， 标 题 文字 -提示 ， 按 钮 文字 -确定 
public void ShowMessageDialogNew(String message) { 
oneButtonA lertNew(activity, message); 


// This method is declared static, with an explicit activity input, so that other 
// components can use it 
public static void oneButtonAlertNew(Activity activity,String message) { 
Log.i(LOG TAG, "One button alert " + message); 
AlertDialog alertDialog = null; 


if (bIsMaterialDesign) { 
alertDialog = new AlertDialog.Builder(activity, android.R.style.Theme_ Material Light Dialog 
Alert).create(); 

} else { 
alertDialog = new AlertDialog.Builder(activity).create(); 


if (bIsDisplaylIcon) { 
alertDialog.setIcon(android.R.drawable.ic_dialog info); 


alertDialog.setTitle("$E 7s"); 

// prevents the user from escaping the dialog by hitting the Back button 
alertDialog.setCancelable(false); 

alertDialog.setMessage(string TOHTML(message)); 


alertDialog.setButton(DialogInterface. BUTTON NEUTRAL, 
"确定 ", new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int which) { 
J3); 

alertDialog.show(); 


@SimpleFunction(description = "显示 选择 框 ， 标 题 文字 -提示 ， 按 钮 文字 -确定 和 取消 ") 
public void ShowChooseDialogNew(String message) { 
twoButtonDialogNew(activity, 
message, 
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" 确 fe", 
new Runnable() {public void run() {AfterChoosing(" 确 定 ");}}，, 
new Runnable() {public void run() {AfterChoosing(activity.getString(android.R.string.cancel));}} 


); 


// This method takes three runnables that specify the actions to be performed 
// when the buttons are pressed. It's declared static with an explicit activity input 
// so that other components can use it. 
public static void twoButtonDialogNew(Activity activity, String message, String title, 
final String button! Text, final Runnable positiveAction, final Runnable cancelAction) { 
Log.i(LOG TAG, "ShowChooseDialog: " + message); 
AlertDialog alertDialog = null; 


if (bIsMaterialDesign) { 
alertDialog = new AlertDialog.Builder(activity, android.R.style.Theme_ Material Light Dialog 


Alert).create(); 
} else { 
alertDialog = new AlertDialog.Builder(activity).create(); 


if (bIsDisplayIcon) { 
alertDialog.setIcon(android.R.drawable.ic_dialog info); 


alertDialog.setTitle(title); 

// prevents the user from escaping the dialog by hitting the Back button 
alertDialog.setCancelable(false); 
alertDialog.setMessage(stringToHTML(message)); 


alertDialog.setButton(AlertDialog., BUTTON POSITIVE, button1 Text, 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int which) { 
positiveAction.run(); 
j 
J} 


// TODO(hal): It would be safer and more consistent to pass in cancelButtonText as a parameter. 
final String cancelButtonText = activity.getString(android.R.string.cancel); 
alertDialog.setButton(AlertDialog., BUTTON NEGATIVE, cancelButtonText, 

new DialogInterface.OnClickListener() { 

public void onClick(DialogInterface dialog, int which) { 

cancelAction.run(); 

} 

J} 


alertDialog.show(); 


@SimpleFunction(description = "显示 文本 输入 框 ， 标 题 文字 -提示 ， 按 钮 文字 -确定 和 取消 
public void ShowTextDialogNew(String message) { 
textInputDialogNew(message); 


//TODO(hal): It would be cleaner to define this in terms of oneButtonAlert and generalize 
// oneButtonAlert so it can be used both for messages and text input. We could have merged 
// this method into ShowTextDialog, but that would make it harder to do the generalization. 
private void textInputDialogNew(String message) { 

AlertDialog alertDialog = null; 


if (bIsMaterialDesign) { 
alertDialog = new AlertDialog.Builder(activity, android.R.style.Theme_ Material Light Dialog 


Alert).create(); 
} else { 
alertDialog = new AlertDialog.Builder(activity).create(); 


if (bIsDisplayIcon) { 
alertDialog.setIcon(android.R.drawable.ic_input_add); 


alertDialog.setTitle("$E7s"); 
alertDialog.setMessage(stringToHTML(message)); 
// Set an EditText view to get user input 
final EditText input = new EditText(activity); 
alertDialog.setView(input); 
// prevents the user from escaping the dialog by hitting the Back button 
alertDialog.setCancelable(false); 
alertDialog.setButton(DialogInterface: BUTTON POSITIVE, "确定 "， 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int which) { 
HideKeyboard((View) input); 
AfterTextInput(input.getText().toString()); 
} 
J); 


final String cancelButtonText = activity.getString(android.R.string.cancel); 
alertDialog.setButton(AlertDialog., BUTTON NEGATIVE, cancelButtonText, 
new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int which) { 
HideKeyboard((View) input); 
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//User pressed CANCEL. Raise AfterTextInput with CANCEL 
AfterTextInput(cancelButtonText); 
} 
J) 
alertDialog.show(); 


} 
在 OdeMessages.java 中 增加 函数 声明 : 


@DefaultMessage("ShowChooseDialogNew") 
@Description("") 
String ShowChooseDialogNewMethods(); 


@DefaultMessage("ShowMessageDialogNew") 
@Description("") 
String ShowMessageDialogNewMethods(); 


@DefaultMessage("ShowTextDialogNew") 
@Description("") 
String ShowTextDialogNewMethods(); 


在 OdeMessages_zh CN.properties 中 增加 属性 的 中 文字 符 串 : 


ShowChooseDialogNewMethods = 显示 选择 对 话 框 


ShowMessageDialogNewMethods = 显示 消息 对 话 框 
ShowTextDialogNewMethods = 显示 文本 对 话 框 


编译 、 运 行 系统 后 ， 在 工作 面板 中 ， 可 以 看 到 增加 了 3 个 新 函数 ， 如 图 11-14 一 图 11-16 


工作 面板 


调用 GSES .显示 选择 对 话 框 
消息 
标题 

按钮 文本 


按钮 2 文本 
允许 撤销 | 


AA ESRD .显示 选择 对 话 框 


显示 选择 框 ， 标 题 文字 -提示 ， 按 钮 文字 -确定 和 取消 


图 11-14 新 增 “ 显 示 选 择 对 话 框 ”函数 


86 


工作 面板 


调用 CGHED .显示 消息 对 话 杠 
消息 
标题 


按钮 文本 


调用 GERD .显示 消息 对 话 框 
消息 
显示 提示 框 ， 标 题 文字 -提示 ， 按 钮 文字 -确定 


图 11-15 新 增 “ 显 示 消息 对 话 框 ”函数 


工作 面板 
调用 CHEAD .显示 文本 对 话 杠 
消 息 
允许 撤销 | 


调用 CSD .显示 文本 对 话 框 
消息 
显示 文本 输入 框 ， 标 题 文字 -提示 ， 按 钮 文字 -确定 和 取消 


图 11-16 新 增 “ 显 示 文 本 对 话 框 ”函数 


11.3 修改 日 志 功 能 


11.3.1 日志 功能 介绍 
对 话 框 组 件 提供 了 3 个 打印 日 志 信息 函数 ， 如 图 11-17 所 示 。 


工作 面板 


调用 GHD .日 志 信息 
消息 


调用 Gis Beas 
消息 


图 11-17 打印 日 志 信息 函数 
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对 应 的 源码 如 下 : 


@SimpleFunction(description = "Writes an error message to the Android system log. " + 


"See the Google Android documentation for how to access the log.") 
public void LogError(String message) { 
Log.e(LOG_TAG message); 


@SimpleFunction(description = "Writes a warning message to the Android log. " + 


"See the Google Android documentation for how to access the log.") 
public void LogWarning(String message) { 
Log.w(LOG_TAG, message); 


@SimpleFunction(description = "Writes an information message to the Android log.") 


public void LogInfo(String message) { 
Log.i(LOG_TAG, message); 
} 


从 源码 可 看 出 ， 这 3 个 函数 是 利用 了 Android 系统 自身 的 Log 机 制 ， 打 印 日 志 。 


在 应 用 中 增加 打印 日 志 的 功能 ， 代 码 如 图 11-18 所 示 。 


工作 面板 


当 CEID .被 单 击 
执行 调用 CHAD .显示 选择 对 话 杠 
消息 


当 CEID .被 单 击 
执行 ” 调用 CHAD .显示 文本 对 话 杠 
消息 


调用 CHED .错误 日 志 调用 GHED 敬告 日 志 


消息 


x z 消息 


当 CEUD .被 单 击 
执行 ”调用 CHEAD eee 
消息 
调用 GSS Amie 


E 消息 


图 11-18 代码 


如 果 要 看 输出 的 日 志 ， 在 电脑 端 启 动 Android 开发 工具 ， 如 Android Studio, 


然 


TN 


后 利 月 


ADB 连接 手机 或 模拟 器 ， 运 行 应 用 ， 就 可 以 看 到 打印 的 日 志 信 息 了 ， 如 图 11-19 所 示 。 


Android Monitor 


EE Emulator 5.1_WVGA_API_23 Android 6.0, API 23 i No Debuggable Processes [c] 
(©) its logcat Monitors +" Verbose 园 & Notifier 
o a 08-28 21:41:13.086 12378-12378/? I/Notifier: ShowChooseDialog: 选择 对 话 框 
æ 08-28 21:41:13.092 12378-12378/? E/Notifier: 选择 对 话 框 


oe 车 08-28 21:41:17.278 12378-12378/? I/Notifier: One button alert 消息 对 话 框 
@ 08-28 21:41:17.283 12378-12378/? I/Notifier: 消息 对 话 框 
E f 08-28 21:41:20.150 12378-12378/? W/Notifier: MAREE 


图 11-19 日 志 信息 
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Log 打印 函数 中 的 TAG， 用 于 外 选 想 要 查看 的 日 志 ， 在 Notifierjava 中 定义 的 TAG 
如 下 : 


private static final String LOG_TAG = "Notifier"; 


可 以 看 到 输出 了 5 条 日 志 ， 其 中 两 条 是 Notifierjava 函数 中 的 日 志 打印 代码 输出 的 : 


public static void oneButtonAlertNew(Activity activity,String message) { 
Log.i(LOG TAG, "One button alert " + message); 


public static void twoButtonDialogNew(Activity activity, String message, String title, 
final String buttonl Text, final Runnable positiveAction, final Runnable cancelAction) { 
Log.i(LOG TAG, "ShowChooseDialog: " + message); 


11.3.2 ”增加 设置 日 志 开关 属性 


打印 日 志 功 能 主要 是 在 应 用 的 开发 阶段 使 用 的 ， 发 布 给 用 户 使 用 的 版 本 中 通常 是 关闭 打 
印 日 志 功 能 的 ， 有 可 能 在 程序 中 多 处 都 添加 了 打印 日 志 的 函数 ， 如 果 再 一 个 个 删除 ， 比 较 麻 
烦 ， 可 以 添加 一 个 属性 控制 是 否 打 印 日 志 。 


// 增 加 标 只 是 否 打 印 日 志 的 变量 里 ， 默认 为 true 
private boolean bIsPrintLog = true; 


增加 设置 和 获取 此 变量 值 的 函数 : 


@SimpleProperty(description = "设置 是 否 打印 日 志 "， 
category = PropertyCategory.BEHAVIOR) 
public boolean IsPrintLog() { 
return bIsPrintLog; 


} 


@DesignerProperty(editorType = PropertyTypeConstants.PROPERTY TYPE BOOLEAN, 
defaultValue = "True") 
@SimpleProperty 
public void IsPrintLog(boolean bIsPrintLog) { 
this.bIsPrintLog = bIsPrintLog; 
} 


在 函数 中 用 此 变量 


控制 是 否 打印 日 志 : 


可 


@SimpleFunction(description = "Writes an error message to the Android system log. "+ 
"See the Google Android documentation for how to access the log.") 
public void LogError(String message) { 
if (bIsPrintLog){ 
Log.e(LOG_TAG message); 
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@SimpleFunction(description = "Writes a warning message to the Android log. "+ 


"See the Google Android documentation for how to access the log.") 
public void LogWarning(String message) { 
if (bIsPrintLog){ 


Log.w(LOG_TAG, message); 
} 


@SimpleFunction(description = "Writes an information message to the Android log.") 
public void LogInfo(String message) { 
if (bIsPrintLog){ 


Log.i(LOG_TAG, message); 
} 


} 


在 OdeMessages.java 中 增加 属性 声明 : 
@DefaultMessage("IsPrintLog") 
@Description("") 


String IsPrintLogProperties(); 


在 OdeMessages_zh_CN.properties 4 


增加 属 


IsPrintLogProperties = 是 否 打印 


= 
a 
+ 


编译 、 运 行 系统 后 ， 在 对 话 框 的 组 们 
属性 ， 默 认为 打印 ， 如 图 


11-20 所 示 。 


yy 
Ud 


im 


a0 


属性 中 ， 可 以 看 到 增加 了 一 个 “是 否 打印 
组 件 属性 


+» 


JAD 的 
对 话 框 1 


背景 颜色 
图 深交 
设置 对 话 框 是 否 显示 图 标 


Fa 


设置 是 否 创建 Material Design 风 格 
的 对 话 框 


是 否 打印 日 志 


图 11-20 
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在 工作 面板 中 ， 也 可 以 看 到 增加 了 此 属 怕 


工作 面板 


的 getter 和 setter 函数 ， 如 图 11-21 所 示 。 


图 11-21 新 增 属性 函数 3 
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第 二 革 输入 框 的 定制 


12.1 输入 框 的 共性 定制 


H 


输入 框 也 是 常 使 用 的 组 件 ，App Inventor 2 默认 提供 了 两 种 输入 框 : 密码 输入 框 
(PasswordTextBox) 和 文本 输入 框 〈TextBox)， 这 两 个 组 件 已 经 具有 了 一 些 属性 和 功能 函数 ，1 
有 些 常用 的 属性 和 功能 函数 并 没有 ， 如 对 于 用 户 输入 字符 个 数 的 限制 和 清空 输入 框 等 功能 。 
密码 输入 框 和 文本 输入 框 在 源码 中 对 应 的 类 分 别 是 PasswordTextBox 和 TextBox， 两 者 
有 共同 的 基 类 TextBoxBase， 只 要 在 TextBase.java 中 增加 上 述 属 性 和 功能 ， 密 码 输 入 框 和 文 
本 输入 框 会 自动 继承 并 拥有 新 增 的 属性 和 功能 。 有 具体 修改 如 下 。 


12.1.1 增加 设置 字符 串 长 度 的 属性 和 核查 函数 
在 TextBase.java 中 的 增加 如 下 代码 : 
/增加 表示 字符 串 长 度 的 变量 


private int textLength; 


@SimpleProperty( 
category = PropertyCategory. BEHAVIOR, 
description = "Set the length of text") 
public int TextLength() { 
return textLength; 


} 


@DesignerProperty(editorType = PropertyTypeConstants.PROPERTY TYPE NON NEGATIVE INTEGER, 
defaultValue = "0") 
@SimpleProperty 
public void TextLength(int length) { 
this.textLength = length; 


} 


@SimpleFunction( 
description = "核查 文本 框 中 的 字符 串 长 度 是 否 和 设置 的 字符 串 长 度 一致 ) 
public boolean CheckTextLength() { 
if (textLength != 0){ 
if (Text().length() == textLength) { 
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return true; 
}else{ 
return false; 
} 
}else{ 
// 如 果 属 性 的 
return true; 


为 0， 则 表示 长 度 没有 限 和 


EG 
I 
= 


} 
在 OdeMessages.java 中 添加 属性 和 函数 的 声明 : 


@DefaultMessage("TextLength") 
@Description("") 
String TextLengthProperties(); 


@DefaultMessage(""CheckTextLength") 
@Description("") 
String CheckTextLengthMethods(); 


在 OdeMessages_zh CN.properties 中 添加 中 文字 符 串 : 


TextLengthProperties = 文本 长 度 

CheckTextLengthMethods = 核查 文本 长 度 
译 、 运 行 系统 后 ， 可 以 看 到 在 密码 输入 框 和 文本 输入 框 的 组 件 属性 中 ， 都 多 了 一 个 
“文本 长 度 ” 的 属性 ， 默 认 值 为 0， 如 图 12-1 所 示 。 


SE 


文本 对 齐 
居 左 : 0 ~ 


文本 颜色 
| 黑色 


文本 长 度 


图 12-1 新 增 属 性 1 


在 工作 面板 中 ， 也 可 以 看 到 增加 了 属性 的 getter 和 setter 函数 ， 如 图 12-2 和 图 12-3 
所 示 。 
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图 12-2 新 增 属性 函数 1 图 12-3 ”新 增 属性 函数 2 
在 两 者 的 工作 面板 中 ， 同 样 可 以 看 到 都 多 了 个 “核查 文本 长 度 ” 的 函数 ， 如 图 12-4 和 
图 12-5 所 示 。 


工作 面板 工作 面板 


.核查 文本 长 度 


图 12-4 新 增 功能 函数 1 图 12-5 ”新 增 功能 函数 2 


使 用 示例 代码 如 图 12-6 所 示 。 


核查 文本 长 度 E Ce 
2 .显示 消息 对 话 杠 
消息 
标题 
按钮 文本 


否则 WA .显示 消息 对 话 框 
消息 
标题 

按钮 文本 


图 12-6 代码 


12.1.2 ”增加 清空 输入 框 的 函数 
在 TextBase.java 中 增加 如 下 代码 : 
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@SimpleFunction(description = "删除 文本 输入 框 中 的 所 有 字符 中 
public void DeleteAllTextO { 
TextViewUtil.setText(view, ""); 


} 
在 OdeMessages.java 中 增加 函数 声明 : 


@DefaultMessage("DeleteAl|Text") 
@Description("") 
String DeleteAlITextMethods(); 


在 OdeMessages_zh CN.properties 中 增加 函数 的 中 文字 符 串 : 


HI 


DeleteAllTextMethods = 清空 输入 框 


译 、 运 行 系统 后 ， 在 密码 输入 框 和 文本 输入 框 的 工作 面板 中 ， 都 可 以 看 到 增加 了 一 个 
“清空 输入 框 ” 的 函数 ， 如 图 12-7 和 图 12-8 所 示 。 


或 


工作 面板 


图 12-7 新 增 功能 函数 3 


图 12-8 新 增 功能 函数 4 


12.2 ”密码 输入 框 (PasswordTextBox) 的 定制 


用 户 在 输入 密码 的 时 候 ， 常 想 看 下 其 体 输入 的 内 容 ， 可 以 增加 设置 密码 明文 或 密 文 显示 
的 函数 ， 方 便 用 户 使 用 。 
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I 
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密码 输入 框 的 源码 文件 是 PasswordTextBox.java， 在 其 中 增加 如 下 代码 : 


import com.google.appinventor.components.annotations.SimpleFunction; 


import android.text.method.HideReturnsTransformationMethod; 


@SimpleFunction(description = "设置 密码 明文 显示 ") 
public void ShowPassword() { 
view.setTransformationMethod(HideReturnsTransformationMethod.getInstance()); 


@SimpleFunction(description = "设置 密码 密 文 显示 ") 
public void HidePassword() { 


view.setTransformationMethod(PasswordTransformationMethod.getInstance()); 


} 
在 OdeMessages.java 中 增加 函数 声明 : 


@DefaultMessage("ShowPassword") 
@Description("") 
String ShowPasswordMethods(); 


@DefaultMessage("HidePassword") 
@Description("") 
String HidePasswordMethods(); 


在 OdeMessages_zh CN.properties 中 增加 函数 的 中 文字 符 串 : 


ShowPasswordMethods = 显示 密码 
HidePasswordMethods = 隐藏 密码 


编译 、 运 行 系统 后 ， 在 密码 输入 村 
IWER” WAKA WB 12-9 所 示 。 
工作 面板 


H 


的 工作 面板 中 ， 可 以 看 到 增加 了 “隐藏 密码 ”和 “ 显 


图 12-9 ”新 增 功能 函数 5 
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12.3 


文本 输入 框 CTextBox ) 的 定制 


许多 应 用 都 需要 用 户 输入 电子 邮箱 地 址 ， 现 增加 一 个 属性 ， 开 发 人 员 可 设置 文本 输入 框 
只 用 于 输入 电子 邮箱 地 址 ， 在 TextBox.java 中 增加 如 下 代码 : 


/属性 变量 
private boolean acceptsEmailAddressOnly; 


@SimpleProperty( 
category = PropertyCategory.BEHAVIOR, 


description = "If true, then this text box accepts only emailaddress as keyboard input.") 
public boolean EmailAddressOnly() { 


return acceptsEmailAddressOnly; 


@DesignerProperty(editorType = PropertyTypeConstants.PROPERTY TYPE BOOLEAN, defaultValue = "False") 
@SimpleProperty( 
description = "If true, then this text box accepts only emailaddress as keyboard input.") 
public void EmailAddressOnly(boolean acceptsEmailAddressOnly) { 
if (acceptsEmailAddressOnly) { 
acceptsNumbersOnly = false; 
view.setInputType( 
InputType. TYPE CLASS TEXT | 
InputType.TYPE_TEXT_VARIATION EMAIL_ADDRESS); 
} else { 
view.setInputType(InputType. TYPE CLASS TEXT | InputType. TYPE TEXT FLAG _ 
MULTI LINE); 
} 
this.acceptsEmailAddressOnly = acceptsEmailAddressOnly; 


} 


在 OdeMessages.java 中 添加 属性 的 声明 : 


@DefaultMessage("EmailAddressOnly") 
@Description("") 
String EmailAddressOnlyProperties(); 


在 OdeMessages_zh_CN.properties 中 添加 中 文字 符 串 : 


EmailAddressOnlyProperties = 仅 限 电子 邮箱 


编译 、 运 行 系统 后 ， 可 以 看 到 在 组 件 属性 中 ， 多 了 一 个 “ 仅 限 电子 邮箱 ”的 属性 


Lor 
m 
~ 


默认 


值 为 不 选 ， 


， 如 图 12-10 所 示 。 
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组 件 属性 
文本 输入 框 1 
背景 颜色 

| 默认 

仅 限 电子 邮箱 


图 12-10 新 增 属性 2 


在 工作 面板 中 也 可 以 看 到 增加 了 属性 的 getter 和 setter 函数 ， 如 图 


工作 面板 


图 12-11 新 增 属 性 函数 3 


12-11 所 示 。 


45137 Web 浏览 框 ( WebView ) 的 定制 


13.1 增加 拨号 功能 


目前 许多 网 页 上 都 显示 有 电话 号 码 ， 供 用 户 在 浏览 网 页 的 时 候 ， 可 以 直接 拨打 电话 ， 
但 App Inventor 2 提供 的 Web 浏览 框 不 文 持 此 功能 ， 使 用 不 方便 ， 现 修改 产 码 使 其 文 持 此 
功能 。 

Web 浏览 框 的 源码 文件 是 WebViewerjava， 首 先 需要 在 此 文件 中 添加 申请 拨打 电话 权限 
的 代码 : 


@UsesPermissions(permissionNames = "android.permission.INTERNET, android.permission.CALL_PHONE") 


创建 浏览 框 时 ， 会 执行 如 下 代码 : 


private void resetWebViewClient() { 
if (SdkLevel.getLevel() >= SdkLevel. LEVEL FROYO){ 
webview.setWebViewClient(FroyoUtil.getWebViewClient(ignoreSslErrors, followLinks, container. 
$form(), webview.getContext(), this)); 
} else { 
webview.setWebViewClient(new Web ViewerClient()); 
} 


目前 用 户 使 用 的 Android 设备 的 系统 版 本 都 大 于 SdkLevel.LEVEL FROYO， 所 以 在 创 
Æ Web 浏览 框 时 ， 还 会 调用 FroyoUtil.java 里 的 getWebViewClient 函数 ; 


public static WebViewClient getWebViewClient(final boolean ignoreErrors, 
final boolean followLinks, final Form form, final Context context, final Component component) { 
return new WebViewClient() { 
@Override 
public boolean shouldOverrideUrlLoading(WebView view, String url) { 
AUT url HAL tel: 开始 ， 则 意味 此 wd 中 包含 了 电话 号 码 ， 单 击 此 url， 调 用 系统 拨号 功能 
if (url.startsWith("tel:")) { 
Intent intent = new Intent(Intent. ACTION VIEW, Uri.parse(url)); 
context.startActivity(intent); 


return true; 


} 
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return !followLinks; 
} 


@Override 
public void onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) { 
if G@gnoreErrors) { 
handler.proceed(); 
} else { 
handler.cancel(); 
form.dispatchErrorOccurredEvent(component, "WebView", 
ErrorMessages.ERROR_WEBVIEW_SSL_ERROR); 


如 图 13-1 所 示 的 网 页 上 有 技术 支持 热线 这 个 电话 号 码 ， 右 边 有 个 拨号 图 标 ， 单 击 此 图 
标 ， 系 统 就 会 调用 设备 上 的 拨号 应 用 ， 显 示 如 网 13-2 所 示 的 拨号 界面 。 


C E % D 11:25 
6900 +2 HERRA 
Bai® 百度 
名 ”添加 到 联系 人 
党 华为 服务 热线 O- HEF 
月 发 送 短信 


全 部 ”问答 ”视频 ”图片 贴吧 资讯 xX 


华为 客服 电话 
© 官方 客服 提示 
以 下 电话 经 百度 手机 卫士 安全 认证 
(400) 830-8300 
技术 支持 热线 
400-830-8300 & 1 2 3 
技术 支持 热线 (EM) i 4 5 
800-830-8300 jt ia i 
TA 8 
华为 商城 客服 热线 QRS UV WXY 
400-088-6888 & < 0 
语音 菜单 在 线 客服 更 多 电话 ®© 
图 13-1 网 页 图 13-2 ”拨号 界面 


除了 增加 拨号 功能 外 ， 也 可 以 通过 判断 url 是 否 以 sms: 开 头 ， 增 加 发 送 短信 的 功能 。 
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13.2 返回 键 功能 的 处 理 


用 App Inventor 2 开发 的 App， 组 件 都 是 附着 在 Screen 上 ， 用 户 单 击 按键 ， 也 是 Screen 
先 接收 按键 事件 ， 对 于 返回 键 的 处 理 代 码 如 下 代码 在 Form java 中 ): 


@Override 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
if (keyCode == KeyEvent. KEYCODE BACK) { 
if (!BackPressed()) { 
boolean handled = super.onKeyDown(keyCode, event); 


a 


AnimationUtil.ApplyCloseScreenAnimation(this, closeAnimType); 
return handled; 
yelse { 


return true; 


} 


return super.onKeyDown(keyCode, event); 


} 


@Override 
protected void onStop() { 
super.onStop(); 
Log.i(LOG TAG "Form "+ formName + " got onStop"); 
for (OnStopListener onStopListener : onStopListeners) { 
onStopListener.onStop(); 


@Override 
protected void onDestroy() { 
super.onDestroy(); 
// for debugging and future growth 
Log.i(LOG_TAG, "Form " + formName + " got onDestroy"); 


// Unregister events for components in this form. 
EventDispatcher.removeDispatchDelegate(this); 


for (OnDestroyListener onDestroyListener : onDestroyListeners) { 
onDestroyListener.onDestroy(); 
j 
} 


当 单 击 返回 键 的 时 候 ， 会 关闭 当前 应 用 的 Screen， 退 出 应 用 ， 返 回 到 系统 桌面 。 
在 用 Web 浏览 框 浏览 网 页 的 时 候 ， 这 样 处 理 的 用 户 体验 非常 粮 烧 ， 用 户 在 查看 完 第 三 
级 网 页 的 时 候 ， 想 再 看 下 第 二 级 网 页 ， 结 果 一 单 击 返回 键 ， 直 接 就 退出 应 用 了 。 
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可 以 在 Formjava F, X} Web 浏览 框 的 情况 做 特殊 处 理 ， 代 码 如 下 : 


@Override 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
if (keyCode == KeyEvent. KEYCODE BACK) { 


a 


/判断 是 否 可 以 返回 上 一 级 网 页 ， 如 果 可 以 则 调用 Web 浏览 框 的 goBack 函数 ， 如 有 果 不 能 
/返回 ， 则 执行 原 有 代码 

if (Web Viewer.isCanGoBack()) { 

Web Viewer.goBack(); 


return true; 


} 


if (!BackPressed()) { 
boolean handled = super.onKeyDown(keyCode, event); 
AnimationUtil.ApplyCloseScreenAnimation(this, closeAnimType); 
return handled; 
} else { 
return true; 
} 
} 
return super.onKeyDown(keyCode, event); 


} 


在 WebViewerjava 中 增加 两 个 静态 函数 ， 供 Form.java 调用 : 


public static boolean isCanGoBack() { 
if (webview == null){ 
return false; 
} else { 
return webview.canGoBack(); 
} 
} 


public static void goBack() { 
webview.goBack(); 


} 


13.3 ”增加 加 载 网 页 事件 响应 函数 


在 使 用 应 用 加 载 网 页 的 时 候 ， 由 于 网 络 等 原因 ， 可 能 需要 等 竺 一 会 才能 全 部 加 载 完 网 
Kl; 最 好 是 在 开始 加 载 网 页 的 时 候 ， 给 用 户 提示 信息 ， 加 载 完成 后 ， 提 示 信 息 自 动 消失 ， 以 
改善 用 户 体验 。 

在 FroyoUtil java 中 增加 如 下 代码 : 
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import android.graphics.Bitmap; 


public static WebViewClient getWeb ViewClient(final boolean ignoreErrors, 


final boolean followLinks, final Form form, final Context context, final Component component) { 


return new WebViewClient() { 
/开始 加 载 网 页 时 会 调用 的 函数 
@Override 


public void onPageStarted(WebView view, String url, Bitmap favicon) { 


super.onPageStarted(view, url, favicon); 


form.onPageStarted(url); 


/完成 网 页 加 载 时 调用 
@Override 
public void onPageFinis 


的 函数 


hed(WebView view, String url) { 


super.onPageFinished(view, url); 


form.onPageF inished(url); 


} 
在 Form.java 中 增加 如 下 代码 : 


@SimpleEvent(description = "了 


于 始 加 载 网 页 的 响应 函数 ") 


public void OnPageStarted(String url) { 
EventDispatcher.dispatchEvent(this, "OnPageStarted", url); 


public void onPageFinished(String url) { 


OnPageFinished(url); 


@SimpleEvent(description = "完成 网 页 加 载 的 响应 函数 ") 
public void OnPageFinished(String url) { 
EventDispatcher.dispatchEvent(this, "OnPageFinished", url); 


} 


在 OdeMessages.java HH J0 ek 


数 声明 : 


@DefaultMessage("OnPageStarted") 


@Description("") 
String OnPageStartedEvents(); 
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@DefaultMessage("OnPageFinished") 
@Description("") 
String OnPageFinishedEvents(); 


在 OdeMessages_zh CN.properties 中 增加 函数 的 中 文字 符 串 : 


OnPageStartedEvents = 开始 加 载 网 页 
OnPageFinishedEvents = 完成 网 页 加 载 


局 译 、 运 行 系统 后 ， 在 工作 面板 界面 ， 可 以 看 到 增加 了 “完成 网 页 加 载 ” 和 “开始 加 载 


网 页 ”两 个 事件 响应 函数 ， 如 图 13-3 所 示 。 
使 用 示例 代码 如 图 13-4 所 示 。 


zÈ 


当 .开始 加 载 网 页 
_URL 网 址 
WG 调用 CGHED .显示 进程 对 话 框 


“URL 消息 
标题 


4 GSEs .开始 加 载 网 页 Screen! .完成 网 页 加 载 


URL 网 址 _URL 网 址 ， 
执行 由 调用 CHH .关闭 进程 对 话 杠 


图 13-3 ”增加 函数 图 13-4 代码 
(这 两 个 函数 把 正在 加 载 网 页 的 网 址 作为 参数 传递 ， 也 可 以 提示 用 户 正在 加 载 网 页 的 网 址 。) 
实现 效果 如 图 13-5 所 示 。 


K 13-5 加载 网 页 
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第 14 章 PARAS EH 


14.1 音频 播放 器 (Player) 的 定制 


14.1.1 增加 权限 


音频 播放 器 的 源码 文件 为 Playerjava， 其 中 申 


Qt 


青 了 如 下 权限 : 


@UsesPermissions(permissionNames = "android.permission. VIBRATE, android.permission. INTERNET") 


< 


目 没有 申请 读 取 存 储 空 间 的 权限 ， 导 致 如 果 应 用 中 没有 使 用 其 他 可 以 读 取 存储 空间 的 组 


件 ， 只 使 用 音频 播放 器 组 件 的 时 候 ， 音 频 播 放 器 无 法 读 取 存 储 空间 的 文件 。 现 增加 读 取 存储 


2o 


间 的 权限 ， 解 决 此 问题 ， 代 码 如 下 : 


@UsesPermissions(permissionNames = "android.permission. VIBRATE, android.permission. INTERNET, 


android.permission. READ EXTERNAL STORAGE") 


14.1.2 ”增加 获取 数据 函数 


> 


pe 


App Inventor 2 在 视频 播放 器 中 提供 了 获取 文件 时 长 的 函数 ， 但 音频 播放 器 中 没有 提 


E， 现 增加 此 函数 。 代 码 如 下 : 


@SimpleFunction(description = "获取 文件 的 时 长 ") 
public int GetDuration() { 
if (playerState == State. PREPARED || playerState == State. PLAYING || playerState == State. PAUSED _ 
BY_USER) { 
return player.getDuration(); 
} else { 
return 0; 
j 
j 


同时 也 增加 一 个 获取 当前 播放 时 长 的 函数 : 


@SimpleFunction(description = "获取 当前 播放 时 长 ") 
public int GetCurrentPosition() { 


return player.getCurrentPosition(); 


} 
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在 OdeMessagesjava 中 增加 函数 声明 : 


@DefaultMessage("GetCurrentPosition") 
@Description("") 
String GetCurrentPositionMethods(); 


在 OdeMessages_zh CN.properties 中 增加 函数 的 中 文字 符 串 : 
GetCurrentPositionMethods = 获取 当前 播放 时 长 


GetDuration 函数 的 名 称 和 视频 播放 器 中 的 函数 名 称 相同 ， 属 于 系统 原 有 的 ， 就 不 需要 
在 OdeMessages.java 和 OdeMessages_zh_CN.properties 中 增加 声明 和 字符 串 。 
遍 译 、 运 行 系统 后 ， 在 工作 面板 中 ， 可 以 看 到 增加 了 “获取 当前 播放 时 长 ”和 “ 求 时 


长 ”两 个 新 函数 ， 如 图 14-1 所 示 。 
工作 面板 


Ra 


调用 .获取 当前 播放 时 长 
Se ae) ~ KIEK 


tS es] ~ ee 


ae 
Te 


mp 
S 


曾 功能 函数 1 


图 14-1 


14.1.3 ”增加 播放 函数 


App Inventor 2 在 视频 播放 器 中 提供 了 跳 到 指定 的 时 长 处 的 函数 ， 但 音频 播放 器 中 没有 
提供 ， 现 增加 此 函数 。 代 码 如 下 : 


@SimpleFunction(description = " 跳 到 指定 的 时 长 处 0 
public void SeekTo(int ms) { 
if (ms <0) { 
ms = 0; 


} 


pause(); 
player.seekTo(ms); 
Start); 

} 


SeekTo 函数 的 名 称 和 视频 播放 器 中 的 函数 名 称 相 同 ， 属 于 系统 原 有 的 ， 就 不 需要 在 
OdeMessages.java 和 OdeMessages_zh_CN.properties 中 增加 声明 和 字符 串 。 
译 、 运 行 系统 后 ， 在 工作 面板 中 ， 可 以 看 到 增加 了 “搜寻 ”函数 ， 如 图 14-2 所 示 。 


或 
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图 14-2 ”新 增 功能 函数 2 


14.2 视频 播放 器 (VideoPlayer ) 的 定制 


y 


视频 


w 


番 放 器 的 源码 文件 为 VideoPlayer.java， 其 中 申请 了 如 下 权限 : 


@UsesPermissions(permissionNames = "android.permission.INTERNET") 
但 没有 申请 读 取 存储 空间 的 权限 ， 导 致 如 果 应 用 中 没有 使 用 其 他 可 以 读 取 存 储 空间 的 组 


件 ， 只 使 用 视频 播放 器 组 件 的 时 候 ， 视 频 播 放 器 无 法 读 取 存 储 空间 的 文件 。 现 增加 读 取 存储 
空间 的 权限 ， 解 决 此 问题 ， 代 码 如 下 : 


@UsesPermissions(permissionNames = "android.permission.INTERNET, android.permission.READ _ 
EXTERNAL_STORAGE") 
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15% mifi (Canvas ) 的 定制 


App Inventor 2 的 画布 提供 了 绘制 图 形 的 功能 ， 但 能 绘制 的 图 形 比较 少 ， 且 功能 比较 单 
一 ; 而 Android 系统 本 身 的 绘图 功能 是 非常 强大 的 ， 可 以 利用 Android 系统 提供 的 函数 增强 
画布 的 功能 。 
画布 的 源码 文件 为 Canvas.java， 在 其 中 增加 以 下 代码 。 


15.1 增加 画图 函数 


体 的 代码 如 下 : 


I RA 
@SimpleFunction 


public void DrawArc(int left, int top, int right, int bottom, float startAngle, float sweepAngle, boolean 
useCenter, boolean fill) { 

float correctedLeft = left * $form().deviceDensity(); 

float correctedTop = top * $form().deviceDensity(); 

float correctedRight = right * $form().deviceDensity(); 

float correctedBottom = bottom * $form().deviceDensity(); 


Paint p = new Paint(paint); 

p.setStyle(fill ? Paint.Style.FILL : Paint.Style. STROKE); 

view.canvas.drawArc(correctedLeft, correctedTop, correctedRight, correctedBottom, startAngle, 
sweepAngle, useCenter, p); 

view. invalidate(); 


/ 画 椭 区 
@SimpleFunction 


public void DrawOval(int left, int top, int right, int bottom, boolean fill) { 
float correctedLeft = left * $form().deviceDensity(); 
float correctedTop = top * $form().deviceDensity(); 
float correctedRight = right * $form().deviceDensity(); 
float correctedBottom = bottom * $form().deviceDensity(); 


Paint p = new Paint(paint); 

p.setStyle(fill ? Paint.Style.FILL : Paint.Style. STROKE); 
view.canvas.drawOval(correctedLeft, correctedTop, correctedRight, correctedBottom, p); 
view. invalidate(); 


108 


// 画 矩形 
@SimpleFunction 

public void DrawRect(int left, int top, int right, int bottom, boolean fill) { 
float correctedLeft = left * $form().deviceDensity(); 

float correctedTop = top * $form().deviceDensity(); 

float correctedRight = right * $form().deviceDensity(); 

float correctedBottom = bottom * $form().deviceDensity(); 


Paint p = new Paint(paint); 
p.setStyle(fill ? Paint.Style.FILL : Paint.Style. STROKE); 
view.canvas.drawRect(correctedLeft, correctedTop, correctedRight, correctedBottom, p); 


view. invalidate(); 


// 男 圆 角 矩形 

@SimpleFunction 

public void DrawRoundRect(int left, int top, int right, int bottom, int rx, int ry, boolean fill) { 
float correctedLeft = left * $form().deviceDensity(); 

float correctedTop = top * $form().deviceDensity(); 

float correctedRight = right * $form().deviceDensity(); 

float correctedBottom = bottom * $form().deviceDensity(); 

float correctedRx = rx * $form().deviceDensity(); 

float correctedRy = ry * $form().deviceDensity(); 


Paint p = new Paint(paint); 

p.setStyle(fill ? Paint.Style.FILL : Paint.Style. STROKE); 
view.canvas.drawRoundRect(correctedLeft, correctedTop, correctedRight, correctedBottom, 
correctedRx, correctedRy, p); 

view. invalidate(); 


15.2 ”增加 绘制 路 径 函 数 


在 实际 生活 中 ， 要 绘制 的 图 形 是 各 种 各 样 的 ， 为 了 增加 绘制 各 种 图 形 的 灵活 性 ， 
Android 系统 还 提供 了 一 个 类 : Path， 用 于 绘制 各 种 形状 的 路 径 ， 也 可 以 理解 为 绘制 各 种 形 
状 图 形 的 轮廓 。 

增加 如 下 代码 : 


o 


import android.graphics.Path; 


/增加 Path 类 变量 
private final Path path; 
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/在 构造 函数 中 初始 化 变量 


public Canvas(ComponentContainer container) { 


mul 


path = new Path(); 


/设置 路 径 的 起 点 

@SimpleFunction 

public void PathStart(int x, int y) { 
float correctedX = x * $form().deviceDensity(); 
float corrected Y = y * $form().deviceDensity(); 


path.moveTo(correctedX, corrected Y); 


/设置 路 径 的 节点 
@SimpleFunction 


public void PathlineTo(int x, int y) { 
float correctedX = x * $form().deviceDensity(); 
float corrected Y = y * $form().deviceDensity(); 


path.lineTo(correctedX, correctedY); 


线 


= 


/设置 路 径 为 三 次 贝 赛 尔 
@SimpleFunction 


public void PathCubicTo(int x1, int yl, int x2, int y2, int x3, int y3) { 
float correctedX1 = x1 * $form().deviceDensity(); 
float correctedY 1 = y1 * $form().deviceDensity(); 
float correctedX2 = x2 * $form().deviceDensity(); 
float corrected Y2 = y2 * $form().deviceDensity(); 
float correctedX3 = x3 * $form().deviceDensity(); 
float corrected Y3 = y3 * $form().deviceDensity(); 


path.cubicTo(correctedX1, correctedY 1, correctedX2, correctedY2, correctedX3, corrected Y 3); 


/设置 路 径 为 二 次 贝 塞 尔 曲线 

@SimpleFunction 

public void PathQuadTo(int x1, int y1, int x2, int y2) { 
float correctedX1 = x1 * $form().deviceDensity(); 
float correctedY 1 = y1 * $form().deviceDensity(); 
float correctedX2 = x2 * $form().deviceDensity(); 
float corrected Y2 = y2 * $form().deviceDensity(); 
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path.quadTo(correctedX1, correctedY 1, correctedX2, correctedY2); 


/设置 为 封闭 路 径 

@SimpleFunction 

public void PathClose() { 
path.close(); 


/绘制 路 径 
@SimpleFunction 
public void DrawPath(boolean fill) { 
Paint p = new Paint(paint); 
p.setStyle(fill ? Paint.Style.FILL : Paint.Style. STROKE); 
view.canvas.drawPath(path, p); 
view. invalidate(); 


/清空 路 径 

@SimpleFunction 

public void PathReset() { 
path.reset(); 


15.3 ”增加 滑动 事件 响应 函数 


App Inventor 2 提供 了 手指 在 屏幕 上 按 下 和 手 松 开 时 的 事件 响应 函数 ， 但 没有 提供 手 # 


在 屏幕 上 滑动 时 的 事件 响应 函数 ， 这 样 就 无 法 实现 诸如 手指 在 屏幕 上 滑动 的 同时 ， 绘 制图 
的 功能 。 增 加 此 响应 函数 的 代码 如 下 : 


@SimpleEvent 
public void TouchMove(float x, float y) { 
EventDispatcher.dispatchEvent(this, "TouchMove", x, y); 


void parse(MotionEvent event) { 
int width = Width(); 
int height = Height(); 


// Coordinates less than 0 can be returned if a move begins within a 

// view and ends outside of it. Because negative coordinates would 
// probably confuse the user (as they did me) and would not be useful, 
// we replace any negative values with zero. 

float x = Math.max(0, (int) event.getX() / $form().deviceDensity()); 
float y = Math.max(0, (int) event.getY() / $form().deviceDensity()); 
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W OY 


switch (event.getAction()) { 


case MotionEvent.ACTION MOVE: 


/在 此 接收 系统 发 出 的 移动 事件 消息 
TouchMove(x, y); 


15.4 ”设置 函数 参数 的 默认 值 


在 Drawerjs 文件 的 component method 数组 中 ， 增 加 如 下 代码 ， 把 上 述 函 数 的 布尔 型 参 
数 的 默认 值 设 置 为 TRUE。 


Y 


{matchingMutatorAttributes: {component_type:"Canvas", method_name:"DrawArc"}, 
mutatorXMLStringFunction: function(mutatorAttributes) { 
return " + 
'<xml>' + 
<block type="component_method">' + 
//mutator generator 
Blockly. Drawer.mutatorA ttributesToXMLString(mutatorAttributes) + 
‘<value name="ARG6"><block type="logic_boolean"><title name="BOOL">TRUE<X<‘/title> 
</block></value>' + 
‘<value name="ARG7"><block type="logic_boolean"><title name="BOOL">TRUE<X<‘(title> 
</block></value>' + 
‘</block>' + 


‘</xml>'}}, 


{matchingMutatorA ttributes: {component_type:"Canvas", method _name:"DrawOval"}, 
mutatorXMLStringFunction: function(mutatorAttributes) { 
return " + 
'<xml>' + 
<block type="component_method">' + 
//mutator generator 
Blockly. Drawer.mutatorA ttributesToXMLString(mutatorAttributes) + 
‘<value name="ARG4"><block type="logic_boolean"><title name="BOOL">TRUE<‘(title> 
</block></value>' + 
‘</block>' + 


‘</xml>';}}, 
{matchingMutatorA ttributes: {component_type:"Canvas", method_name:"DrawRect"}, 


mutatorXMLStringFunction: function(mutatorAttributes) { 
return " + 
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<xml>' + 

<block type="component_method">' + 

//mutator generator 

Blockly. Drawer.mutatorA ttributesToXMLString(mutatorAttributes) + 

‘<value name="ARG4"><block type="logic_boolean"><title name="BOOL">TRUE<X<‘/title> 
</block></value>' + 

‘</block>' + 


‘</xml>'}}}, 


{matchingMutatorA ttributes: {component_type:"Canvas", method_name:"DrawRoundRect"}, 
mutatorXMLStringFunction: function(mutatorAttributes) { 
return " + 
'<xml>' + 
<block type="component_method">' + 
//mutator generator 
Blockly. Drawer.mutatorA ttributesToXMLString(mutatorAttributes) + 
‘<value name="ARG6"><block type="logic_boolean"><title name="BOOL">TRUE<X<‘/title> 
</block></value>' + 
‘</block>' + 


‘</xml>'}}, 


{matchingMutatorA ttributes: {component_type:"Canvas", method_name:"DrawPath"}, 
mutatorXMLStringFunction: function(mutatorAttributes) { 
return " + 
<xml>' + 
<block type="component_method">' + 
//mutator generator 
Blockly. Drawer.mutatorA ttributesToXMLString(mutatorAttributes) + 
‘<value name="ARGO0"><block type="logic_boolean"><title name="BOOL">TRUE<X<‘/title> 
</block></value>' + 
‘</block>' + 


/xml> 


15.5 ”增加 声明 和 中 文字 符 串 


在 OdeMessages.java 中 增加 如 下 函数 和 参数 的 声明 : 


@DefaultMessage("DrawArc") 
@Description("") 
String DrawArcMethods(); 


@DefaultMessage("DrawOval") 


@Description("") 
String DrawOvalMethods(); 
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@DefaultMessage("DrawRoundRect") 
@Description("") 
String DrawRoundRectMethods(); 


@DefaultMessage("PathStart") 
@Description("") 
String PathStartMethods(); 


@DefaultMessage("PathlineTo") 
@Description("") 
String PathlineToMethods(); 


@DefaultMessage("PathCubicTo") 
@Description("") 
String PathCubicToMethods(); 


@DefaultMessage(""PathQuadTo") 
@Description("") 
String PathQuadToMethods(); 


@DefaultMessage("PathClose") 
@Description("") 
String PathCloseMethods(); 


@DefaultMessage("DrawPath") 
@Description("") 
String DrawPathMethods(); 


@DefaultMessage(""PathReset") 
@Description("") 
String PathResetMethods(); 


@DefaultMessage(""TouchMove") 
@Description("") 
String TouchMoveEvents(); 


@DefaultMessage("x3") 
@Description("") 
String x3Params(); 


@DefaultMessage("startAngle") 
@Description("") 


String startAngleParams(); 


@DefaultMessage("sweepAngle") 
@Description("") 
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String sweepAngleParams(); 


@DefaultMessage("useCenter") 
@Description("") 
String useCenterParams(); 


@DefaultMessage("r x") 
@Description("") 
String rxParams(); 


@DefaultMessage("r y") 
@Description("") 
String ryParams(); 


在 OdeMessages_zh CN.properties 中 增加 中 文字 符 串 : 


DrawArcMethods = mia} 
DrawOvalMethods = iý 
DrawRoundRectMethods = Mi IA f$ 4E É 
PathStartMethods = 路 径 起 点 
PathlineToMethods = 路 径 节点 
PathCubicToMethods = 三 次 贝 塞 尔 曲线 
PathQuadToMethods = 二 次 贝 塞 尔 曲 线 
PathCloseMethods = 封闭 路 径 
DrawPathMethods = 绘制 路 径 
PathResetMethods = 清空 路 径 
TouchMoveEvents = 手指 在 画布 上 移动 


3 


angleParams = 角度 
startAngleParams = 开始 角度 
sweepAngleParams = 弧 形 的 角度 
useCenterParams = 是 否 封闭 弧 形 
rxParams = x 四方 向 圆 角 半径 
ryParams = y 轴 方 向 圆 角 半径 


编译 、 运 行 系统 后 ， 在 工作 面板 中 ， 可 以 看 到 增加 了 如 图 15-1 一 图 15-6 所 示 函 数 。 
工作 面板 


~ 


当 .手指 在 画布 上 移动 
XxX 坐标 yet 


图 15-1 新 增 事件 响应 函数 
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调用 . 画 弧 形 
left 
top 


right 


bottom 

开始 角度 

弧 形 的 角度 
EGHAM (ES 


图 15-2 新 增 功能 函数 1 


调用 BE 
left 

top 

right 

bottom 


调用 -BAER 
left 

top 

right 

bottom 

x 轴 方 向 圆 角 半径 

y 轴 方向 圆 角 半径 


图 15-4 ”新 增 功能 函数 3 


调用 . 画 椭圆 
left 

top 

right 

bottom 


调用 .绘制 路 径 
填充 | 


图 15-3 ”新 增 功能 函数 2 


调用 .封闭 路 径 


调用 .三 次 贝 塞 尔 曲线 
x1 
yl 
x2 
y2 
x3 
y3 


调用 .二 次 贝 塞 尔 曲线 
x1 


yl 
x2 


y2 


图 15-5 ”新 增 功能 函数 4 


调用 .路 径 节点 
x 坐标 
y 坐 标 


图 15-6 新 增 功能 函数 5 
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15.6 ”路 径 函 数 使 用 示例 


如 果 要 画 一 个 三 角形 ， 并 且 三 角形 内 部 是 填充 的 ， 使 用 常规 的 画图 函数 是 无 法 实现 的 ， 
这 就 需要 用 路 径 函 数 来 实现 。 
具体 代码 如 图 15-7 所 示 。 


EScreenT v 区 水 < 
执 生 时 设置 CAD . CELE 
调用 .路 径 起 点 
x 坐标 
y 坐 标 
E .路 径 节点 
x 坐标 


y 坐 标 


调用 .路 径 节点 
x 坐标 

| y 坐 标 
调用 .封闭 路 径 
调用 .绘制 路 径 


、 调 用 CM -; 


图 15-7 代码 


绘制 的 图 形 如 图 15-8 所 示 。 


图 15-8 填充 的 三 角形 


在 调用 “绘制 路 径 ” 函 数 后 ， 要 调用 “清空 路 径 ” 函 数 清除 路 径 数 据 ， 和 否则 下 次 绘制 的 
时 候 ， 会 重复 之 前 的 绘制 。 
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第 16 章 ”文件 管理 吉 (File) 的 定制 


16.1 增加 文件 处 理 函 数 


里 器 没有 修改 文件 名 和 获取 文件 大 小 两 个 常 有 


Te 


TT 


App Inventor 2 内 置 的 文 伯 
改 源 码 实现 这 两 个 功能 。 
文件 管理 器 的 源码 文件 是 File.java， 在 其 中 增加 两 个 函数 : 


@SimpleFunction(description = "修改 文件 名 ") 
public void Rename(String oldFileName, String newFileName) { 
java.io.File file = new java.io.File(oldFileName); 


if(!file.exists()) { 


try { 
file.createNewFile(); 
} catch IOException e) { 
form.dispatchErrorOccurredEvent(File.this, "RenameFile", 
ErrorMessages.ERROR_ CANNOT CREATE FILE, oldFileName); 


return; 


} 


file renameTo(new java.io.File(newFileName)); 


} 


@SimpleFunction(description = "获取 文件 大 小 ") 
public long GetFileSize(String fileName) { 
java.io.File file = new java.io.File(fileName); 


if(file.exists()) { 
return file.length(); 
yelse { 
return 0; 
} 
} 
在 OdeMessages.java 中 增加 函数 和 函数 参数 的 声明 

/函数 声明 
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昌 功 能 ， 现 修 


@DefaultMessage("GetFileSize") 
@Description("") 
String GetFileSizeMethods(); 


@DefaultMessage("Rename") 

@Description("") 

String RenameMethods(); 

/函数 参数 声明 ，fleName 参数 的 声明 是 系统 原先 就 有 的 
@DefaultMessage("fileName") 

@Description("") 

String fileNameParams(); 


@DefaultMessage("oldFileName") 
@Description("") 
String oldFileNameParams(); 


@DefaultMessage("newFileName") 
@Description("") 
String newFileNameParams(); 


在 OdeMessages_zh CN.properties 中 增加 函数 和 参数 的 中 文字 符 串 : 


fileNameParams = 文件 名 
oldFileNameParams = 旧 文 件 名 
newFileNameParams = 新 文件 名 
RenameMethods = 修改 文件 名 
GetFileSizeMethods = 获取 文件 大 小 


局 译 、 运 行 系统 后 ， 在 工作 面板 中 ， 可 以 看 到 增加 了 “获取 文件 大 小 ”和 “ 读 取 文件 
名 ”两 个 函数 ， 如 图 16-1 所 示 。 


工作 面板 


或 


调用 .删除 
文件 名 


调用 .获取 文件 大 小 
文件 名 


.修改 文件 名 
旧 文 件 名 
新 文件 名 


图 16-1 新 增 功能 函数 1 
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16.2 ”增加 获取 存储 区 信息 的 函数 


增加 两 个 函数 用 于 获取 存储 空间 根 目录 和 剩余 存储 空间 大 小 ， 代 码 如 下 : 


@SimpleFunction(description = "获取 存储 空间 根 目录 '") 
public String GetExternalStorageDirectory() { 


return Environment.getExternalStorageDirectory().getPath(); 


} 


// 返 回 值 的 单位 是 byte 
@SimpleFunction(description = "获取 剩余 存储 空间 大 小 ") 
public long GetUsableSpace() { 
return Environment.getExternalStorageDirectory().getUsableSpace(); 


} 


在 OdeMessages.java 中 增加 函数 的 声明 ， 


@DefaultMessage("GetExternalStorageDirectory") 
@Description("") 
String GetExternalStorageDirectoryMethods(); 


@DefaultMessage("GetUsableSpace") 
@Description("") 
String GetUsableSpaceMethods(); 


在 OdeMessages_zh CN.properties 中 增加 函数 的 中 文字 符 串 : 


GetExternalStorageDirectoryMethods = 获取 存储 空间 根 目录 
GetUsableSpaceMethods = 获取 剩余 存储 空间 大 小 


局 译 、 运 行 系统 后 ， 在 工作 面板 中 ， 可 以 看 到 增加 了 “获取 存储 空间 根 目 录 ” 和 “获取 
剩余 存储 空间 大 小 ”两 个 函数 ， 如 图 16-2 所 示 。 


工作 面板 


车 


调用 .获取 存储 空间 根 目录 


调用 .获取 文件 大 小 
文件 名 


调用 .获取 剩余 存储 空间 大 小 


图 16-2 新 增 功能 函数 2 
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第 17 章 微 数 据 库 组 件 (TinyDB ) 的 定制 


17.1 存储 功能 介绍 


微 数据 库 组 件 的 源码 文件 是 TinyDB.java， 创 建 数据 库 的 代码 如 下 : 


public TnyDB(ComponentContainer container) { 
super(container.$form()); 


context = (Context) container.$context(); 
sharedPreferences = context.getSharedPreferences("TinyDB1", Context. MODE PRIVATE); 


} 


从 代码 中 可 以 看 出 ， 微 数据 库存 储 是 利用 了 Android 系统 的 SharedPreferences 框架 ， 保 
存 和 检索 原始 数据 类 型 的 永久 性 键 值 对 。 可 以 使 用 SharedPreferences 来 保存 任何 原始 数据 : 
布尔 值 、 浮 点 值 、 整 型 值 、 长 整 型 和 字符 串 。 即 使 应 用 停止 运行 了 ， 数 据 也 会 被 保留 。 

这 种 框架 是 把 数据 保存 在 xml 文件 中 ，getSharedPreferences 函数 中 的 第 一 个 参数 就 
xml 的 文件 名 ， 第 二 个 参数 标识 对 这 个 文件 的 操作 模式 ，MODE _ PRIVATE 标识 此 文件 只 能 
被 创建 它 的 应 用 ， 或 与 此 应 用 有 相同 use ID 的 应 用 进行 读 写 操作 。 还 有 以 下 几 种 模式 : 
MODE WORLD READABLE, MODE WORLD WRITEABLE 和 MODE MULTI PROCESS. 
但 通常 都 使 用 MODE PRIVATE 这 种 模式 。 

创建 的 xml 文件 存储 在 Android 设备 的 如 下 路 径 : 


T 


/data/data/ 应 用 的 包 名 /shared_prefs 


在 应 用 中 向 微 数据 库 中 存 入 数据 的 代码 如 图 17-1 所 示 。 


图 17-1 代码 1 
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文件 : 


root@generic x86:/data/data/appinventor.ai test.demo, 
TinyDB1.xml 


appinventor.ai_test.demo 是 应 用 的 包 名 
TinyDB1.xml 就 是 创建 的 xml 文件 ， 


mi 


利用 Android 系统 的 adb 和 shell 命令 ， 在 Android 模拟 器 的 如 下 路 径 可 以 看 到 创建 的 xml 


/shared_prefs # 1s 


FP 的 内 容 如 下 : 


<?xml version='1.0' encoding='utf-8' standalone='yes' ?> 


<map> 


<string name=" 城 市 ">&quot 上 海 &quot;</string> 
<string name="city">&quot;shanghai&quot;</string> 


</map> 


17.2 ”增加 设置 数据 文件 名 称 和 数据 加 


密 功 能 


通常 在 应 用 中 ， 数 据 可 能 需要 存储 在 不 同 的 xml 文件 中 ， 但 App Inventor 2 默认 所 有 的 


数据 都 存储 在 TinyDB1.xml 这 个 文件 中 ， 使 用 不 灵活 。 


现 修 改 代码 ， 增 加 以 下 函数 ， 使 开发 人 员 可 以 


比 原 有 函数 多 出 的 name 参数 ， 就 是 xml 文件 的 名 称 。 


， 其 中 相 


TT 


Ei FETE ALY xml 文人 


[=R 


进行 加 密 处 理 ，StoreValueNew 函数 的 最 


有 时 为 了 安全 起 见 ， 保 存 到 本 地 的 数据 还 需要 
后 一 个 参数 标识 是 否 对 数据 进行 MD5 加 密 。 
增加 如 下 代码 : 


import java.security. MessageDigest; 
import java.security.NoSuchAlgorithmException; 


@SimpleFunction 


public void StoreValueNew(final String name, final String tag, final Object valueToStore, final boolean 


blIsEncryption) { 


sharedPreferencesNew = context.getSharedPreferences(name, Context. MODE PRIVATE); 


final SharedPreferences.Editor sharedPrefsEditor = sharedPreferencesNew.edit(); 


try { 


String jsonString = JsonUtil.getJsonRepresentation(valueToStore); 


if (!bIsEncryption) { 


sharedPrefsEditor.putString(tag, jsonString); 


} else { 
String encryptedString = makeMD5Hash(j 


sonString); 


sharedPrefsEditor.putString(tag, encryptedString); 


} 
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sharedPrefsEditor.commit(); 
} catch (ISONException e) { 
throw new YailRuntimeError("Value failed to convert to JSON.", "JSON Creation Error."); 


j 
@SimpleFunction 
public Object GetValueNew(final String name, final String tag, final Object valueIfTagNotThere) { 
try { 
sharedPreferencesNew = context.getSharedPreferences(name, Context. MODE PRIVATE); 
String value = sharedPreferencesNew.getString(tag, ""); 
// If there's no entry with tag as a key then return the empty string. 
// was return (value. length() == 0) ? "" : JsonUtil.getObjectFromJson(value); 
return (value.length() == 0) ? valuelfTagNotThere : JsonUtil.getObjectFromJson(value); 
} catch (SONException e) { 
throw new YailRuntimeError("Value failed to convert from JSON.", "JSON Creation Error."); 
j 
} 
@SimpleFunction 


public Object GetTagsNew/(final String name) { 
sharedPreferencesNew = context.getSharedPreferences(name, Context. MODE PRIVATE); 


List<String> keyList = new ArrayList<String>(); 
Map<String,?> keyValues = sharedPreferencesNew.getAll(); 
// here is the simple way to get keys 

keyList.addAll(key Values.keySet()); 
java.util.Collections.sort(keyList); 

return keyList; 


@SimpleFunction 
public void ClearAllNew(final String name) { 
sharedPreferencesNew = context.getSharedPreferences(name, Context. MODE PRIVATE); 


final SharedPreferences.Editor sharedPrefsEditor = sharedPreferencesNew.edit(); 
sharedPrefsEditor.clear(); 
sharedPrefsEditor.commit(); 


@SimpleFunction 
public void ClearTagNew/(final String name, final String tag) { 
sharedPreferencesNew = context.getSharedPreferences(name, Context. MODE PRIVATE); 
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final SharedPreferences.Editor sharedPrefsEditor = sharedPreferencesNew.edit(); 
shared PrefsEditor.remove(tag); 
sharedPrefsEditor.commit(); 


private String makeMDS5Hash(String key) { 

String cacheKey; 

try { 
final MessageDigest mDigest = MessageDigest.getInstance("MD5"); 
mDigest.reset(); 
mDigest.update(key.getBytes()); 
cacheKey = bytesToHexString(mDigest.digest()); 

} catch (NoSuchAlgorithmException e) { 
cacheKey = String. valueOf(key.hashCode()); 

} 


return cacheKey; 


private String bytesToHexString(byte[] bytes) { 
StringBuilder sb = new StringBuilder(); 
for (byte value : bytes) { 
String hex = Integer.toHexString(OxFF & value); 
if (hex.length() == 1) { 
sb.append('0'); 
} 
sb.append(hex); 
} 


return sb.toString(); 


} 
在 OdeMessages.java 中 增加 函数 和 参数 声明 : 


@DefaultMessage("GetValueNew") 
@Description("") 
String GetValueNewMethods(); 


@DefaultMessage("Store ValueNew") 
@Description("") 
String StoreValueNewMethods(); 


@DefaultMessage("ClearAlINew") 
@Description("") 
String ClearAlINewMethods(); 


@DefaultMessage("ClearTagNew") 
@Description("") 
String ClearTagNewMethods(); 
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@DefaultMessage("GetTagsNew") 
@Description("") 
String GetTagsNewMethods(); 


/参数 声明 
@DefaultMessage("bIsEncryption") 
@Description(") 

String bIsEncryptionParams(); 


在 OdeMessages_zh CN.properties 中 增加 函数 和 参数 的 中 文字 符 串 : 


GetValueNewMethods = 获取 数值 
StoreValueNewMethods = 保存 数值 
ClearAlINewMethods = 清除 所 有 数据 
ClearTagNewMethods = 清除 标签 数据 
GetTagsNewMethods = 获取 标签 数据 


bIsEncryptionParams = 4277 


I 


App Inventor 2 提供 的 “获取 数值 ”函数 ， 如 果 输 入 的 标签 不 存在 ， 则 返回 空 字 符 串 ， 


AA EEU AE 
标签 


如 图 17-2 所 示 。 新 增 的 “获取 数值 ”函数 ， 同 样 也 能 
实现 此 功能 。 

StoreValueNew 函数 的 最 后 一 个 参数 值 默 认为 无 标签 时 返回 什 
false， 不 对 数据 加 密 。 

需要 修改 drawerjs 文件 ， 实 现 对 参数 默认 赋值 ， 
代码 如 下 : 


PS 


17-2 原 有 “获取 数值 ”函数 


component_method: [ 


{matchingMutatorA ttributes: {component_type:"TinyDB", method_name:"StoreValueNew"}, 
mutatorXMLStringFunction: function(mutatorAttributes) { 
return "+ 
<xml> + 
<block type="component_method">' + 
//mutator generator 
Blockly.Drawer.mutatorAttributesToXMLString(mutatorAttributes) + 
‘<value name="ARG3"><block type="logic_boolean"><title name="BOOL">FALSE</title> 
</block></value>' + 
'</block>' + 


‘</xml>';}}, 


{matchingMutatorA ttributes: {component_type:"TinyDB", method_name:"GetValueNew"}, 
mutatorXMLStringFunction: function(mutatorAttributes) { 
return" + 
'<xml>' + 
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<block type="component_method">' + 

//mutator generator 

Blockly.Drawer.mutatorA ttributesToXMLString(mutatorAttributes) + 

‘<value name="ARG2"><block type="text"><title name="TEXT"></title></block></value>" + 
‘</block>' + 

‘</xml>'3}}, 


] 


编译 、 运 行 系统 后 ， 在 工作 面板 中 ， 可 以 看 到 增加 了 5 个 新 函数 ， 这 5 个 函数 比 原 有 函 
数 多 了 参数 : 名 称 ， 用 于 处 理 不 同 的 xml 文件 ， 如 图 17-3 一 图 17-5 所 示 。 


工作 面板 


.清除 所 有 数据 


.清除 所 有 数据 
名 称 


.清除 标签 数据 
标签 


.清除 标签 数据 
名 称 
标签 


.获取 标签 数据 


.获取 标签 数据 
名 称 


图 17-3 ”新 增 功能 函数 1 


.获取 数值 

名 称 

标签 

无 标签 时 返回 值 


图 17-4 新 增 功能 函数 2 图 17-5 新 增 功能 函数 3 
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17.3 ”使 用 示例 


保存 数据 的 代码 如 图 17-6 所 示 。 


图 17-6 代码 2 


执行 完 后 ， 在 如 下 路 径 里 可 以 看 到 创建 的 两 个 xml 文件 ; 


root@generic_x86:/data/data/appinventor.ai_test.demo/shared_prefs # 1s 
man.xml 


woman.xml 


man.xml 的 内 容 如 下 : 


<?xml version='1.0' encoding="utf-8' standalone='yes' ?> 
<map> 
<string name=" 姓 名 ">&quot; 王 刚 &quot;</string> 


</map> 


woman.xml 的 内 容 如 下 : 


<?xml version='1.0' encoding="utf-8' standalone='yes' ?> 
<map> 
<string name=" 姓 名 ">&quot; 王 芳 &quot;</string> 


</map> 


读 取 文件 内 容 的 示例 代码 如 图 17-7 所 示 。 


执行 | 调用 Gis Ennai 


无 标签 时 返回 值 


图 17-7 代码 3 
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执行 结果 如 图 17-8 所 示 。 


数据 加 密 示 例 代码 如 图 17-9 所 示 。 


图 17-8 执行 结果 1 


图 17-9 代码 4 


代码 执行 完 后 ， 会 生成 两 个 文件 ，plaintext.xml 的 内 容 如 下 : 


<?xml version='1.0' encoding="utf-8' standalone='yes' ?> 


<map> 


<string name="password">&quot;123abc&quot;</string> 


</map> 


ciphertext.xml 的 内 容 如 下 : 


<?xml version='1.0' encoding="utf-8' standalone='yes' ?> 


<map> 


<string name="password">6def699c 15f62b9d814ee315b8ce9ac4</string> 


</map> 


通过 使 用 MDS 加 密 ， 把 明文 字符 
“6def699c15f62b9d814ee315b8ce9ac4”。 
读 取 数据 的 代码 如 图 17-10 所 示 。 
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中 


sj 


“123abc” 转 成 了 一 个 32 位 长 度 的 字符 串 


.显示 消息 对 话 杠 
消息 ©) 合并 字符 串 | WAE .获取 数值 
名 称 
标签 
无 标签 时 返回 值 


.获取 数值 
名 称 
标签 

无 标签 时 返回 值 


图 17-10 代码 5 


执行 结果 如 图 17-11 所 示 。 


@ 提示 


123abc-6def699c15f62b9d814ee315b8ce9ac4 


图 17-11 执行 结果 2 
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第 18 章 Web 客户 端的 定制 


18.1 增加 PATCH 请 求 函 数 


Web 客户 端 组 件 给 开发 人 员 提 供 了 GET. POST, PUT 和 DELETE 请 求 的 功能 函数 ， 但 
没有 提供 PATCH 请 求 的 功能 函数 ，PATCH 请 求 用 于 资源 的 部 分 内 容 的 更 新 ， 例 如 ， 更 新 某 
一 个 字段 ， 也 属于 比较 常用 的 请 求 。 

Web 客户 端 组 件 的 源码 文件 是 Web.java， 在 


0 


FP 增加 如 下 代码 : 


@SimpleFunction(description = "Performs an HTTP PATCH request using the Url property and "+ 
"the specified text.<br>" + 
"The characters of the text are encoded using UTF-8 encoding.<br>" + 
"If the SaveResponse property is true, the response will be saved in a file and the " + 
"GotFile event will be triggered. The responseFileName property can be used to specify " + 
"the name of the file.<br>" + 
"If the SaveResponse property is false, the GotText event will be triggered.") 
public void PatchText(final String text) { 
requestTextImpl(text, "UTF-8", "PatchText", "PATCH"); 
} 


@SimpleFunction(description = "Performs an HTTP PATCH request using the Url property and " + 
"the specified text.<br>" + 
"The characters of the text are encoded using the given encoding.<br>" + 
"If the SaveResponse property is true, the response will be saved in a file and the " + 
"GotFile event will be triggered. The ResponseFileName property can be used to specify " + 
"the name of the file.<br>" + 
"If the SaveResponse property is false, the GotText event will be triggered.") 
public void PatchTextWithEncoding(final String text, final String encoding) { 
requestTextImpl(text, encoding, "PatchTextWithEncoding", "PATCH"); 
} 


在 OdeMessages.java 中 增加 函数 声明 : 


@DefaultMessage(""PatchText") 
@Description("") 
String PatchTextMethods(); 
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@DefaultMessage("PatchTextWithEncoding") 
@Description("") 
String PatchTextWithEncodingMethods(); 


在 OdeMessages_zh CN.properties 中 增加 函数 的 中 文字 符 串 : 


PatchTextMethods = 执行 PATCH 文本 请 求 
PatchTextWithEncodingMethods = 执行 PATCH 编码 文本 请 求 


局 译 、 运 行 系统 后 ， 在 工作 面板 中 ， 可 以 看 到 增加 了 “执行 PATCH 文本 请 求 ” 和 “ 执 
行 PATCH 编码 文本 请 求 ”两 个 功能 函数 ， 如 图 18-1 所 示 。 


工作 面板 


或 


调用 (ESS .执行 PATCH 文本 请 求 
文本 


调用 .执行 PATCH 编码 文本 请 求 
文本 
字符 编码 


图 18-1 Web 客户 端 新 增 函 数 


18.2 ”增加 设置 JSON 格式 数据 的 属性 


目前 应 用 和 服务 器 间 传 输 数据 大 多 采用 JSON 格式 的 数据 ，App Inventor 2 提供 了 解析 
JSON 格式 数据 的 功能 函数 ， 却 没有 提供 向 服务 器 传递 JSON 格式 数据 的 功能 。 

在 使 用 “执行 POST 文本 请 求 ”函数 向 服务 器 传递 数据 时 ， 利 用 抓 包 工具 ， 可 以 看 到 如 
图 18-2 所 示 的 数据 。 


User-Agent: Dalvik/1.6.0 (Linux; U; Android 4.4.2; Android SDK built for x86 Build/KK) 
Host: restapi.amap.com 

Connection: Keep-Alive 

Accept-Encoding: gzip 

Content-Type: application/x-www-form-urlencoded 

Content-Length: 118 


图 18-2 数据 


其 中 Content-Type 的 值 就 是 用 于 服务 器 指示 传递 的 数据 格式 类 型 ， 默 认 不 是 JSON 格 
式 ， 即 使 传递 给 服务 器 的 数据 是 ISON 格式 ， 但 服务 器 根据 Content-Type 的 值 按 非 JSON 
格式 数据 解析 ， 导 致 解析 出 错 。 如 果 要 传递 JSON 格式 数据 ， 就 需要 设置 Content-Type 
的 值 。 

在 Web.java 中 增加 如 下 代码 : 
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/标识 是 否 使 用 JSON 格式 数据 
private static boolean bIsJSON; 


private static Http URLConnection openConnection(CapturedProperties webProps, String http Verb) 
throws IOException, ClassCastException, ProtocolException { 


HttpURLConnection connection = (HttpURLConnection) webProps.url.openConnection(); 


/如 果 使 用 JSON 格式 数据 ， 设 置 Content-Type WIA A"application/json", 77 Wie MERU AE 


if (bIsJSON) { 
connection.setRequestProperty("Content-Type", "application/json"); 
} else { 
connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded"); 
} 

return connection; 
} 
@SimpleProperty(category = PropertyCategory. BEHAVIOR, description = "设置 是 否 传递 JSON 格式 
的 数据 给 服务 器 ") 
public boolean IsJSON() { 

return bIsJSON; 
} 


@DesignerProperty(editorType = PropertyTypeConstants. PROPERTY TYPE BOOLEAN, default 
Value = "False") 
@SimpleProperty 
public void IsJSON(boolean bIsJSON) { 
this. bIsJSON = bIsJSON; 
j 


在 OdeMessages.java 中 增加 函数 声明 : 


@DefaultMessage("IsJSON") 
@Description("") 
String IsJSONProperties(); 


Ud 


在 OdeMessages zh CN.properties 中 增加 属性 的 中 文字 符 串 : 


ISJSONProperties = 使 用 JSON 格式 数据 
编译 、 运 行 系统 后 ， 在 组 件 属性 中 ， 可 以 看 到 增加 了 “使 用 ISON 格式 数据 ”的 属性 ， 
如 图 18-3 所 示 。 

在 工作 面板 中 ， 可 以 看 到 增加 了 此 属性 的 gette 和 setter 函数 ， 如 图 18-4 所 示 。 


= 
i 


par 
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组 件 属性 


Web 客 户 端 1 


允许 使 用 Cookies 


使 用 JSON 格 式 数 据 


响应 文件 名 称 


图 18-3 Web 客户 端 新 增 属性 


H 
IR 


18-4 Web 客户 端 新 增 属性 函数 
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S197 插件 (Extension ) 开发 


m 


为 了 扩展 App Inventor 2 的 功能 ， 除 了 修改 App Inventor 2 原 有 的 组 件 外 ， 还 可 以 自己 天 
发 功能 插件 ， 方 便 开 发 应 用 使 用 。 


19.1 加 密 功 能 插件 


19.1.1 ”插件 的 实现 


之 前 提 到 过 的 加 密 功 能 ， 就 可 以 做 成 一 个 插件 ， 使 用 起 来 更 灵活 。 
首先 需要 建立 存放 插件 源码 的 文件 夹 : 


ot 


/appinventor/components/src/com/qz/extensions 
然后 创建 源码 文件 Encryption.java， 其 中 的 代码 如 下 : 


// 插 件 的 包 名 ， 通 常 是 三 段 式 com. + 功能 描述 . + extension 
package com.encryption.extension; 


import android.content.Context; 

import android.util.Log; 

import com.google.appinventor.components.annotations.DesignerComponent; 
import com.google.appinventor.components.annotations.SimpleF unction; 
import com.google.appinventor.components.annotations.SimpleObject; 
import com.google.appinventor.components.common.ComponentCategory; 


import com.google.appinventor.components.runtime.*; 


import java.security. MessageDigest; 
import java.security.NoSuchAlgorithmException; 


@DesignerComponent( 
/插件 的 版 本 号 
version = Encryption.VERSION， 
/插件 的 说 明文 字 
description = "功能 : 数据 加 密 开发 者 : QZ", 
/如 果 在 网 上 有 插件 的 说 明文 字 ， 可 以 在 此 设置 网 址 
helpUrl = "http://www.baidu.com", 
/设置 组 件 的 类 型 为 插件 
category = ComponentCategory.EXTENSION, 
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// 插 件 是 否 可 见 ， 由 于 目前 App Inventor 2 只 能 开发 和 使 用 不 可 见 的 插件 ， 因 此 这 里 
/成 true 

nonVisible = true, 

// 插 件 的 图 标 ， 在 此 使 用 App Inventor 2 提供 的 图 标 


iconName = "images/extension.png") 


‘a 
= 
z 

i 


=i 


/lexternal 的 值 为 tue， 设 置 此 组 件 为 外 部 组 件 ， 编 译 器 会 将 此 java 文件 打包 生成 一 个 aix 文件 
@SimpleObject(external = true) 
public class Encryption extends AndroidNonvisibleComponent implements Component { 
public static final int VERSION = 1; 
private ComponentContainer container; 
private Context context; 
private static final String LOG_TAG = "Encryption"; 
public Encryption(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 
context = (Context) container.$context(); 
Log.d(LOG_TAG, "Encryption Created" ); 


/此 插件 对 外 提供 的 函数 
@SimpleFunction(description = "对 数据 进行 MDS 加 密 ") 
public String make MDSHash( String srcStr) { 
String MDS5Str; 
try { 
final MessageDigest mDigest = MessageDigest.getInstance("MD5"); 
mDigest.reset(); 
mDigest.update(srcStr.getBytes()); 
MDSStr = bytesToHexString(mDigest.digest()); 
} catch (NoSuchAlgorithmException e) { 
MDSStr = String. valueOf(srcStr.hashCode()); 


} 
return MDSStr; 


private String bytesToHexString(byte[] bytes) { 
StringBuilder sb = new StringBuilder(); 
for (byte value : bytes) { 
String hex = Integer.toHexString(OxFF & value); 
if (hex.length() == 1) { 
sb.append('0'); 
} 
sb.append(hex); 
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19.1.2 
在 


return sb.toString(); 


插件 的 编译 


appinventor 目录 下 执行 “ant extensions” 命 令 即 可 生成 相应 的 插件 :com.encryption. 


extension.aix， 生 成 的 文件 存放 路 径 如 下 : 


19.1.3 


使 
1) 


appinventor-sources/appinventor/components/build/extensions/com.encryption.extension.aix 


插件 的 导入 


插件 ， 首 先 需 要 导入 插件 ， 具 体 步骤 如 下 : 
单 击 图 19-1 所 示 组 件 面板 最 下 面 的 “Import extension” 字 符 串 标签 ， 显 示 图 19-2 


所 示 对 话 框 。 


2) 


多 了 个 名 为 “Encryption ”的 插件 。 


3) 
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组 件 面板 

用 户 界面 

界面 布局 

多 媒体 

绘图 动画 

传感器 

社交 应 用 

数据 存储 isy com-encryption.extension.aix 


通信 连接 


From my computer URL 


乐高 机 器 人 @ 
试验 性 质 

取消 Import 
Extension 


Import extension 


TFA 


图 19-1 组 件 面 板 图 19-2 导入 对 话 让 


选择 文件 后 ， 单 市 “Import” 按钮， 可 以 看 到 如 图 19-3 所 示 的 界面 ， 组 件 面板 底部 


Extension 


Import extension 


$| Encryption 


图 19-3 ”插件 被 导入 


单 击 问 号 图 标 ， 可 以 看 到 如 图 19-4 所 示 DesignerComponent 注解 添加 的 说 明文 字 。 


Import extension 
$ Encryption 7) 轴 


功能 : 数据 加 密 开发 者 : QZ 


更 多 信息 
SS lets 


图 19-4 插件 说 明 


然后 就 可 以 像 使 用 App Inventor 2 自 带 的 组 件 那 样 使 用 插件 了 。 如 图 19-5 所 示 可 以 把 插 
件 添加 在 组 件 列 表 中 ， 且 在 工作 面板 中 可 以 看 到 插件 提供 的 函数 ， 如 图 19-6 所 示 。 


工作 面板 
组 件 列表 组 件 属性 调用 | Encryption1 ~ | .makeMD5Hash 
SrcStr 

日 Screen] Encryption! 对 数据 进行 MD5 加 密 

图 19-5 ”添加 插件 到 组 件 列表 图 19-6 ”加 密 功 能 插件 函数 

19.1.4 插件 的 使 用 
使 用 示例 代码 如 图 19-7 所 示 。 
当 ES .被单 击 
MT kB GCD. EZ33 为 | 调用 Gee .makeMD5Hash 


srcStr 


图 19-7 ”加 密 功 能 插件 使 用 代码 


因为 是 插件 开发 ， 没 有 修改 App Inventor 2 里 的 资源 文件 ， 所 以 即使 App Inventor 2 的 系 
统 语言 设置 为 中 文 ， 插 件 的 函数 和 参数 名 都 是 英文 。 


19.2 对话 框 插 件 


19.2.1 ”插件 的 实现 
也 可 以 对 系统 提供 的 组 件 进行 插件 开发 ， 如 对 系统 对 话 框 组 件 进行 插件 开发 ， 把 
Notifierjava 文件 名 改 为 QZNotifierjava， 以 便 与 原 有 的 文件 区 别 ， 然 后 复制 到 /appinventor/ 


components/src/com/qz/extensions 中 。 


对 源码 做 如 下 修改 : 


//package com.google.appinventor.components.runtime; 


/修改 包 名 
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package com.notifier.extension; 


import com.google.appinventor.components.runtime.*; 


/修改 DesignerComponent 注解 的 相关 内 容 

@DesignerComponent(version = QZNotifier. VERSION, 
category = ComponentCategory.EXTENSION, 
description = "功能 ， 显 示 各 类 对 话 框 ”开发 者 : QZ"， 
nonVisible = true, 


iconName = "images/extension.png") 


/修改 SimpleObject 注解 的 相关 内 容 

@SimpleObject(external = true) 

/根据 java 语言 规范 ， 把 类 名 和 构造 函数 名 称 改 成 和 文件 名 一 至 

public final class QZNotifier extends AndroidNonvisibleComponent implements Component { 
/增加 插件 的 版 本 号 变量 
public static final int VERSION = 1; 


public QZNotifier (ComponentContainer container) { 
super(container.$form()); 
activity = container.$context(); 
handler = new Handler(); 
progressDialog = null; 


19.2.2 HPA 


编译 并 按 之 前 描述 的 步骤 导入 、 添 加 插件 到 组 件 列表 中 后 ， 在 组 件 属性 中 看 到 有 英文 属 
性 ， 如 图 19-8 所 示 。 


组 件 列表 组 件 属性 
= Screenl QZNotifier1 
按钮 1 背景 颜色 
文本 输入 框 1 图 深交 
型 Encryption1 IsDisplaylcon 
* QZNotifier1 


IsMaterialDesign 


IsPrintLog 
显示 时 长 
长 延 时 ~ 
文本 颜色 
口 白色 


图 19-8 插件 提供 的 属性 
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在 工作 面板 中 ， 看 到 有 英文 函数 ， 如 图 19-9 和 图 19-10 所 示 。 


工作 面板 


调用 OASE .ShowChooseDialogNew 
消息 


调用 .显示 消息 对 话 框 
消息 


标题 
按钮 文本 


调用 COATE .ShowMessageDialogNew 
消息 


图 19-9 ”对 话 框 插件 函数 1 


调用 .显示 文本 对 话 框 


消息 
标题 
允许 撤销 


调用 (CYA .ShowTextDialogNew 


统 语言 设置 为 中 文 ， 新 增 的 函数 和 属性 名 称 都 是 英文 。 
19.3 ”获取 设备 和 系统 信息 插件 


此 插件 用 于 获取 设备 和 设备 上 运行 的 系统 的 相关 信息 ， 包 括 设备 型 号 、 设 备 的 IMEI 号 


码 、 设 备 屏 幕 的 宽度 、 设 备 屏 幕 的 高 度 、 
当前 时 间 和 当前 运行 应 用 的 版 本 号 等 。 


19.3.1 ”插件 的 实现 


在 存放 插件 源码 的 文件 夹 /appinventorcomponents/src/comy/qz/extensions 下 创建 源码 文人 


imi 


的 代码 如 下 : 


SystemInfo.java, 


package com.systeminfo.extension; 


import android.content.Context; 
import android.util.Log; 


消息 


屏幕 的 DPI %2 


图 19-10 ”对 话 框 插件 函数 2 


因为 是 开发 插件 ， 没 有 修改 App Inventor 2 里 的 资源 文件 ， 所 以 即使 App Inventor 2 的 系 


cH API 级 别 、 系 统 的 版 本 、 系 统 


TT 


import com.google.appinventor.components.annotations. DesignerComponent; 


import com.google.appinventor.components.annotations.SimpleEvent; 


import com.google.appinventor.components.annotations.SimpleFunction; 


import com.google.appinventor.components.annotations.SimpleObject; 


import com.google.appinventor.components.common.ComponentCategory; 


import com.google.appinventor.components.annotations.UsesPermissions; 


import com.google.appinventor.components.runtime.*; 


import android.content.Context; 


import android.content.pm.Packagelnfo; 


import android.content.pm.PackageManager; 


import android.telephony. TelephonyManager; 


import android.util.DisplayMetrics; 
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import android.view. View; 

import android.view. WindowManager; 
import java.text.SimpleDateFormat; 
import java.util.Date; 


@DesignerComponent(version = SystemInfo. VERSION, 
description = "功能 : 获取 设备 和 系统 信息 ”开发 者 : QZ", 
helpUrl = "http://blog.csdn.net/xjbelz", 
category = ComponentCategory. EXTENSION, 


nonVisible = true, 


iconName = "images/extension.png") 


@SimpleObject(external = true) 
@UsesPermissions(permissionNames = "android.permission. READ PHONE STATE") 
public class SystemInfo extends AndroidNonvisibleComponent { 

public static final int VERSION = 1; 

private ComponentContainer container; 


private Context context; 


private static final String LOG_TAG = "SystemInfo"; 
public SystemInfo(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 


context = (Context) container.$context(); 


Log.d(LOG_TAG "SystemInfo Created" ); 


@SimpleFunction(description = "获取 设备 型 写 ") 
public String GetModel() { 
return android.os. Build MODEL; 


@SimpleFunction(description = "获取 设备 的 IMEI 号 ") 

public String GetIMEI() { 
TelephonyManager tm = (TelephonyManager) context.getSystemService(Context. TELEPHONY _ 
SERVICE); 
return tm.getDeviceld(); 


@SimpleFunction(description = "获取 屏幕 的 宽度 

public int GetWidth() { 
WindowManager wm = (WindowManager) context.getSystemService(Context. WINDOW _ 
SERVICE); 
return wm.getDefaultDisplay().getWidth(); 
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@SimpleFunction(description = "获取 屏幕 的 高 度 ") 
public int GetHeight() { 


WindowManager wm = (WindowManager) context.getSystemService(Context. WINDOW _ 


SERVICE); 
return wm.getDefaultDisplay().getHeight(); 


@SimpleFunction(description = "获取 屏幕 的 DPI 
public int GetDPI() { 
return context.getResources().getDisplay Metrics().density Dpi; 


@SimpleFunction(description = "获取 系统 的 API 级 别 ") 
public String GetSysAPI() { 
return android.os.Build. VERSION.SDK; 


@SimpleFunction(description = "获取 系统 的 版 本 ") 
public String GetSysVersion() { 
return android.os.Build. VERSION.RELEASE; 


@SimpleFunction(description = "R AZ =4 Hi HY Taek") 
public long GetSysTimeStamp() { 


return System.currentTimeMillis(); 


@SimpleFunction(description = "获取 系统 当前 时 间 ") 
public String GetSysTime() { 
long time=System.currentTimeMillis(); 


Date date=new Date(time); 
SimpleDateFormat format=new SimpleDateFormat("yyyyMMddHHmmss"); 


return format.format(date); 


@SimpleFunction(description = "获取 当前 运行 应 用 的 版 本 ") 
public String GetAppVersion() { 


try { 
PackageManager pm = context.getPackageManager(); 


PackageInfo packageInfo = pm.getPackageInfo(context.getPackageName(),Package 


Manager.GET CONFIGURATIONS); 


return packageInfo.versionName; 
} catch (Exception e) { 
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e.printStackTrace(); 


} 
return null; 


} 


把 插件 导入 项 目 ， 并 添加 到 组 件 列表 后 ， 在 工作 面板 中 可 以 看 到 插件 提供 的 函数 ， 如 
19-11 所 示 。 


工作 面板 


8A Systeminfol GetSYSAPI 


A Systeminfol ~ .GetSysTime 
ia GASES .GetSysTimeStamp 
调用 Systeminfol ~ -GetSysVersion 


调用 Systeminfol ~ .GetWidth 
stemInfol = 


图 19-11 获取 设备 和 系统 信息 插件 函数 


19.3.2 ”插件 的 使 用 


Android 系统 有 多 个 版 本 ， 各 版 本 支持 的 功能 也 不 完全 一 样 ， 像 前 面 描述 过 的 实现 对 话 
框 显示 风格 为 Material Design 风格 的 功能 ， 只 有 在 Android5.0(API 21) 及 以 上 版 本 中 是 默认 
支持 的 ， 在 使 用 这 个 功能 时 ， 就 需要 获取 系统 的 版 本 ， 看 其 是 否 支 持 此 功能 。 

示例 代码 如 图 19-12 所 示 。 


z 初始 化 
AOE AA CEE Recs > Ta") 
则 BE CHED. 设置 是 否 创 建 Material Design 风 格 的 对 


~ 


图 19-12 获取 设备 和 系统 信息 插件 使 用 代码 1 


对 话 框 的 默认 显示 风格 是 非 Material Design 风格 的 ， 在 Screen 初始 化 的 时 候 ， 获 取 当 前 
系统 的 API， 当 值 大 于 等 于 21 时， 设置 显示 风格 为 Material Design 风格 。 
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有 时 在 退出 某 个 屏幕 的 时 候 ， 需 要 保存 数据 到 文件 中 ， 以 便 后 续 使 用 ， 这 类 文件 是 App 


m 


19.4 


自动 保存 的 ， 不 需要 用 户 输入 文件 名 ， 但 又 需要 保证 文件 名 的 唯一 性 ， 就 可 以 使 用 保存 文件 
的 系统 当前 时 间作 为 文件 名 ， 代 码 如 图 19-13 所 示 。 


在 使 


H 


x .被 回 压 
执行 ”调用 .保存 文件 


站 只 


图 19-13 获取 设备 和 系统 信息 插件 使 用 代码 2 


监测 ; 冬 备 电量 状态 插件 


用 移动 设备 的 时 候 ， 经 常 遇 到 电量 不 足 的 情况 ， 如 果 应 用 要 用 到 一 些 比较 耗 电 的 功 


能 ， 如 多 媒体 功能 和 上 网 功能 等 ， 最 好 要 实时 监测 设备 的 电量 状态 ， 以 便 提 供 更 好 的 用 户 
体验 。 
Android 系统 提供 了 系统 广播 ， 用 于 监测 设备 的 电量 状态 ， 包 括 电量 不 足 、 电 量 充 足 和 


电量 发 生 改 变 。 有 具体 的 实现 方式 如 下 。 


19.4.1 ”插件 的 实现 


在 存放 插件 源码 的 文件 夹 /appinventor/components/src/com/qz/extensions 下 创建 源码 文件 


ij 


BatteryState.java， 其 中 的 代码 如 下 : 


package com.batterystate.extension; 


import android.content.Context; 

import android.util.Log; 

import com.google.appinventor.components.annotations.DesignerComponent; 
import com.google.appinventor.components.annotations.SimpleEvent; 

import com.google.appinventor.components.annotations.SimpleObject; 
import com.google.appinventor.components.annotations.UsesPermissions; 
import com.google.appinventor.components.common.ComponentCategory; 


import com.google.appinventor.components.runtime.*; 


import android.content.BroadcastReceiver; 
import android.content.Context; 

import android.content. Intent; 

import android.content.IntentFilter; 


@DesignerComponent(version = BatteryState. VERSION, 
description = "HAE: 监测 电量 状态 ”开发 者 : QZ", 
helpUrl = "http://blog.csdn.net/xjbelz", 
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category = ComponentCategory. EXTENSION, 
nonVisible = true, 


= 


iconName = "images/extension.png") 
@SimpleObject(external = true) 
/申请 获取 电池 状态 的 系统 权限 
@UsesPermissions(permissionNames = "android.permission. BATTERY STATS") 
public class BatteryState extends AndroidNonvisibleComponent implements Component, 
OnDestroyListener { 

public static final int VERSION = 1; 


private ComponentContainer container; 


private Context context; 
private final BatteryStateReceiver batteryStateReceiver; 


private static final String LOG_TAG = "BatteryState"; 
public BatteryState(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 


context = (Context) container.$context(); 
form.registerForOnDestroy(this); 
batteryStateReceiver = new BatteryStateReceiver(); 


registerBatteryState Monitor(); 


Log.d(LOG_TAG "BatteryState Created" ); 


/实现 广播 接收 器 ， 接 收 和 处 理 系统 广播 


private class BatteryStateReceiver extends BroadcastReceiver { 


public BatteryStateReceiver() { 


@Override 
public void onReceive(Context context, Intent intent) { 
String action = intent.getAction(); 
if(Intent. ACTION BATTERY LOW.equals(action)) { 
BatteryStateLow(); 
} else if (Intent. ACTION BATTERY OKAY.equals(action)) { 
BatteryStateOKQ); 
}else if (Intent ACTION BATTERY CHANGED.equals(action)) { 
/ 获得 当前 电量 
int currentLevel = intent. getExtras().getInt("level"); 
/ 获得 总 电量 


int total = intent.getExtras().getInt("scale"); 


int percent = currentLevel * 100 / total; 
BatteryLevel(percent); 


/注册 广播 接收 器 ， 接 收 三 个 系统 广播 


private void registerBatteryState Monitor() { 


IntentFilter intentFilter = new IntentFilter(); 
intentFilter.addAction(Intent. ACTION BATTERY LOW); 
intentFilter.addAction(Intent ACTION BATTERY OKAY); 
intentFilter.addAction(Intent. ACTION BATTERY CHANGED); 
context.registerReceiver(batteryStateReceiver, intentFilter); 


/注销 广播 接收 器 


private void unregisterBatteryStateMonitor() { 


context.unregisterReceiver(batteryStateReceiver); 


/销毁 当前 屏幕 时 ， 注 销 广 播 接收 器 

@Override 

public void onDestroy() { 
unregisterBatteryStateMonitor(); 


/实现 以 下 三 个 事件 函数 ， 供 外 部 调用 

@SimpleEvent(description = "反馈 电量 不 足 ") 

public void BatteryStateLow() { 
EventDispatcher.dispatchEvent(this, "BatteryStateLow"); 


@SimpleEvent(description = "反馈 电量 充足 
public void BatteryStateOK() { 
EventDispatcher.dispatchEvent(this, "BatteryStateOK"); 


@SimpleEvent(description = "有 反馈 电量 百分比 ") 
public void BatteryLevel(int level) { 


EventDispatcher.dispatchEvent(this, "BatteryLevel", level); 


} 


把 插件 导入 项 目 ， 并 添加 到 组 件 列表 后 ， 在 工作 面板 中 可 以 看 到 插件 提供 的 浮 数 ， 如 
图 19-14 所 示 。 
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工作 面板 


=|) BatteryStatel ~ :E11 
level 


4 .BatteryStateLow 
执行 


4 BatteryStatel ~ -BatteryStateOK 
执行 


BatteryState1 ~ 


图 19-14 监测 设备 电量 状态 插件 函数 


19.4.2 ”插件 的 使 用 
使 用 示例 代码 如 图 19-15 和 图 19-16 所 示 。 


当 .BatteryStateLow 

执行 中 调用 CHAED .显示 选择 对 话 框 
消息 
标题 


按钮 文本 
按钮 2 文本 


图 19-15 ”监测 设备 电量 状态 插件 使 用 代码 1 


当 .BatteryStateOK 

TART | 调用 CHED .显示 选择 对 话 框 
消息 
标题 


按钮 文本 


按钮 2 文本 | 
允许 撤销 | 


图 19-16 监测 设备 电量 状态 插件 使 用 代码 2 


上 述 代码 实现 了 如 下 功能 ; 


在 播放 音乐 的 时 候 ， 如 监测 到 电量 不 足 ， 显 示 提 示 框 ， 提 示 用 户 “ 电 量 不 足 ， 是 否 暂 停 


at 


放 音 乐 ?”。 


146 


在 暂停 后 ， 如 监测 到 电 
乐 ? Ro 


limh 


充足 ， 显 示 提 示 框 ， 提 示 用 户 “ 电 量 充 足 ， 是 否 播 放 音 


19.5 ”获取 和 监测 设备 网 络 状态 插件 


在 使 用 移动 设备 的 时 候 ， 移 动 设 


户 使 用 网 络 功 能 的 影响 非常 大 ， 所 
状态 ， 以 便 提供 更 好 的 用 户 体验 。 


Android 系统 提供 了 系统 广播 ， 


， 获 取 设 备 的 网 络 状 态 ， 
态 连接 网 络 。 具体 的 实现 方式 如 


19.5.1 插件 的 实现 
在 存放 插件 


备 的 网 络 状态 经 常 发 生变 化 ， 不 同 的 网 络 状态 ， 对 于 用 
以 如 果 应 用 使 用 了 网 络 功能 ， 同 样 要 实时 监听 设备 的 网 络 


用 于 


F 监 测 设备 的 网 络 状 态 ， 也 可 以 利用 Connectivity 


包括 是 否 连接 网 络 ， 以 及 是 WIFI, 2G. 3G 还 是 4G JÑ 


Fo 


NetworkState.java， 其 中 的 代码 如 下 : 


源码 的 文件 夹 /appinventorcomponents/src/comy/qz/extensions 下 创建 源码 文 伯 


package com.networkstate.extension; 


import android.content.Context; 
import android.util.Log; 


| 


n 
TT 


import com.google.appinventor.components.annotations.DesignerComponent; 


import com.google.appinventor.components.annotations.SimpleEvent; 


import com.google.appinventor.components.annotations.SimpleF unction; 


import com.google.appinventor.components.annotations.SimpleObject; 


import com.google.appinventor.components.annotations.UsesPermissions; 


import com.google.appinventor.components.common.ComponentCategory; 


import com.google.appinventor.components.runtime.*; 


import android.content.BroadcastReceiver; 


import android.content.Context; 
import android.content. Intent; 


import android.content.IntentFilter; 


import android.net.ConnectivityManager; 
import android.net.NetworkInfo; 
import android.telephony. Telephony Manager; 


@DesignerComponent(version = NetworkState. VERSION, 
description = "功能 : 获取 和 监测 网 络 状态 ”开发 者 : QZ", 
helpUrl = "http://blog.csdn.net/xjbelz", 
category = ComponentCategory. EXTENSION, 


nonVisible = true, 


iconName = "images/extension.png") 
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@SimpleObject(external = true) 


//F 


请 获取 网 络 状态 的 系统 权限 


@UsesPermissions(permissionNames = "android.permission.ACCESS NETWORK STATE") 
public class NetworkState extends AndroidNonvisibleComponent implements Component, On 


DestroyListener { 


public static final int VERSION = 1; 

private ComponentContainer container; 

private Context context; 

private final NetworkStateReceiver networkStateReceiver; 
private String networkState; 


private static final String LOG_TAG = "NetworkState"; 
public NetworkState(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 


context = (Context) container.$context(); 
form.registerForOnDestroy(this); 
networkStateReceiver = new NetworkStateReceiver(); 


registerNetworkStateMonitor(); 


Log.d(LOG_TAG "NetworkState Created" ); 


/实现 广播 接收 器 ， 接 收 和 处 理 系统 广播 
private class NetworkStateReceiver extends BroadcastReceiver { 
public NetworkStateReceiver() { 


@Override 
public void onReceive(Context context, Intent intent) { 
String action = intent.getAction(); 
if(ConnectivityManager.CONNECTIVITY_ACTION.equals(action)) { 
networkState = getNetworkState(context); 


NetworkState(networkState); 


/获取 网 络 状 态 : WIFI、 移 动 网 络 ， 还 是 未 连接 网 络 
public String getNetworkState(Context context) { 


ConnectivityManager connectivityManager = (ConnectivityManager) context.getSystem 


Service(Context.CONNECTIVITY _ SERVICE); 
NetworkInfo networkInfo = connectivity Manager.getActiveNetworkInfo(); 
if (networkInfo != null) { 
if (networkInfo.isConnected()) { 
int type = networkInfo.getType(); 


if (type == ConnectivityManager.TYPE WIFI) { 
return "WIFI"; 
} else if (type == ConnectivityManager.TYPE MOBILE) { 
return getNetworkClass(context); 
} 
} else { 
return "未 连接 网 络 "; 


return "未 连接 网 络 "; 


// 当 通过 移动 网 络 上 网 时 ， 获 取 有 具体 的 网 络 类 型 : 2G、3G、4G， 还 是 未 知 网 络 


public String getNetworkClass(Context context) { 


TelephonyManager telephonyManager = (TelephonyManager) context.getSystemService 


(Context. TELEPHONY SERVICE); 


switch (telephonyManager.getNetworkType()) { 
case TelephonyManager. NETWORK TYPE GPRS: 
case TelephonyManager. NETWORK TYPE EDGE: 
case TelephonyManager NETWORK TYPE CDMA: 
case TelephonyManager NETWORK _TYPE_1xRTT: 
case TelephonyManager NETWORK TYPE IDEN: 
{ 


return "2G"; 


case TelephonyManager NETWORK TYPE UMTS: 
case TelephonyManager NETWORK TYPE EVDO 0: 
case TelephonyManager. NETWORK TYPE EVDO A: 
case TelephonyManager. NETWORK TYPE HSDPA: 
case TelephonyManager. NETWORK TYPE HSUPA: 
case TelephonyManager NETWORK TYPE HSPA: 
case TelephonyManager NETWORK TYPE EVDO B: 
case TelephonyManager NETWORK TYPE EHRPD: 
case TelephonyManager NETWORK TYPE HSPAP: 


{ 


return "3G"; 
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case TelephonyManager.NETWORK TYPE LTE: 


{ 
return "4G"; 
} 
default: 
return "未 知 网 络 "; 
} 
} 
// 注 册 广 播 接收 器 


private void registerNetworkStateMonitor(){ 
IntentFilter intentFilter = new IntentFilter(); 


intentFilter.addAction(ConnectivityManager.CONNECTIVITY ACTION); 


context.registerReceiver(networkStateReceiver, intentFilter); 


/注销 广播 接收 器 


private void unregisterNetworkStateMonitor() { 


context.unregisterReceiver(networkStateReceiver); 


/销毁 当前 屏幕 时 ， 注 销 广 播 接收 器 

@Override 

public void onDestroy() { 
unregisterNetworkStateMonitor(); 


@SimpleEvent(description = "反馈 网 络 状态 ， 参 数 的 值 为 以 下 字符 串 : 


未 连接 网 络 、 未 知 网 络 ") 
public void NetworkState(String state) { 
EventDispatcher.dispatchEvent(this, "NetworkState", state); 


a 


@SimpleFunction(description = "获取 网 络 状态 ， 返 回 值 为 以 下 字符 串 : 


4G、 未 连接 网 络 、 未 知 网 络 ") 
public String GetNetworkState() { 
return getNetworkState(context); 


} 


za 


WIFI, 2G, 3G, 4G, 


WIFI. 2G, 3G, 
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把 插件 导入 项 目 ， 并 添加 到 组 件 列表 后 ， 在 工作 面板 中 可 以 看 到 所 


有 件 提供 的 函数 ， 如 


19-17 所 示 。 


工作 面板 


.GetNetworkState 


NetworkState1 ~ 


图 19-17 ”获取 和 监测 设备 网 络 状态 插件 函数 


19.5.2 ”插件 的 使 用 


如 图 19-18 所 示 ， 代 码 用 于 在 通过 网 络 下 载 文件 时 ， 根 据 不 同 的 网 络 状 态 ， 给 用 户 不 同 
的 提示 。 当 网 络 处 于 2G、3G 和 4G 状态 时 ， 提 示 用 户 是 否 暂 停 下 载 文件 ， 当 网 络 处 于 WIFI 
状态 时 ， 提 示 用 户 是 否 下 载 文 件 。 


=f NetworkState1 -NetworkState 


HO... Cr Ca 
则 | 加 OR pero EX 
U AA GES .显示 选择 对 话 框 
消息 


否则 ” 调用 CHAD .显示 选择 对 话 框 
消息 
标题 


WwW 
否则 , AR ETD G3 
U 调用 GSD .显示 消息 对 话 框 
消息 


ha 


图 19-18 ”获取 和 监测 设备 网 络 状态 插件 使 用 代码 1 


在 浏览 网 页 时 ， 因 为 网 页 上 往往 有 许多 图 片 ， 这 对 网 络 状态 要 求 也 比较 高 ， 也 应 根据 不 
同 的 网 络 状态 ， 给 用 户 不 同 的 提示 ， 代 码 如 图 19-19 所 示 。 
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—| NetworkStatel = DOTTIE 
L J 
执行 (5) 如 果 


[x en 


调用 GSI .显示 选择 对 话 框 
消息 


.显示 选择 对 话 框 
消息 
标题 | 

按钮 文本 | “ 
按钮 2 文本 | “ 
AA Ol 
= 
AM, WR | {state ~ =~ 
则 ” 调用 Ei 显示 消息 对 话 杠 
消息 


k 


图 19-19 ”获取 和 监测 设备 网 络 状态 插件 使 用 代码 2 


当 网 络 处 于 2G、3G 和 4G 状态 时 ， 提 示 用 户 是 否 不 显示 图 片 ， 当 网 络 处 于 WIFI 状态 
时 ， 提 示 用 户 是 否 显示 图 片 。 

此 插件 也 提供 了 接口 函数 ， 获 取 网 络 状态 。 每 次 发 起 网 络 请 求 时 ， 可 用 此 函数 判断 当前 
的 网 络 状态 ， 代 码 如 图 19-20 所 示 。 


当 ET .被 单 击 


执行 (©) OR | ”调用 .GetNetworkState [ED 
U AA CE TaD .执行 GET 请 求 


否则 | 调用 GE .显示 消息 对 话 框 
消息 


图 19-20 ”获取 和 监测 设备 网 络 状态 插件 使 用 代码 3 


19.6 ”获取 和 监测 设备 飞行 模式 状态 插件 


当 移 动 设 备 处 于 飞行 模式 状态 时 ， 是 不 能 上 网 和 拨打 电话 的 ，Android 系统 提供 了 系统 
广播 ， 用 于 监测 设备 的 飞行 模式 状态 ， 也 可 以 利用 Settings 类 ， 获 取 飞 行 模式 状态 。 具 体 的 
实现 方式 如 下 。 
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19.6.1 ”插件 的 实现 


在 存放 插件 源码 的 文件 夹 /appinventor/components/src/com/qz/extensions 下 创建 源码 文人 
AirPlaneState.java， 其 中 的 代码 如 下 : 


TT 


package com.airplanestate.extension; 


import android.content.Context; 

import android.util.Log; 

import com.google.appinventor.components.annotations.DesignerComponent; 
import com.google.appinventor.components.annotations.SimpleEvent; 

import com.google.appinventor.components.annotations.SimpleF unction; 
import com.google.appinventor.components.annotations.SimpleObject; 
import com.google.appinventor.components.annotations.UsesPermissions; 
import com.google.appinventor.components.common.ComponentCategory; 


import com.google.appinventor.components.runtime.*; 


import android.content.BroadcastReceiver; 
import android.content.Context; 

import android.content. Intent; 

import android.content.IntentFilter; 

import android.provider.Settings; 


@DesignerComponent(version = AirPlaneState. VERSION, 
description = "功能 ;获取 和 监测 飞行 模式 状态 ”开发 者 : QZ", 
helpUrl = "http://blog.csdn.net/xjbelz", 
category = ComponentCategory.EXTENSION, 


nonVisible = true, 


iconName = "images/extension.png") 


@SimpleObject(external = true) 
public class AirPlaneState extends AndroidNonvisibleComponent implements Component, OnDestroy 
Listener { 

public static final int VERSION = 1; 

private ComponentContainer container; 

private Context context; 

private final AirPlaneStateReceiver airPlaneStateReceiver; 


private static final String LOG_TAG = "AirPlaneState"; 
public AirPlaneState(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 


context = (Context) container.$context(); 


form.registerForOnDestroy(this); 
airPlaneStateReceiver = new AirPlaneStateReceiver(); 
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registerAirPlaneStateMonitor(); 


Log.d(LOG_TAG "AirPlaneState Created" ); 


private class AirPlaneStateReceiver extends BroadcastReceiver { 
public AirPlaneStateReceiver() { 


@Override 
public void onReceive(Context context, Intent intent) { 
String action = intent.getAction(); 
if(Intent. ACTION AIRPLANE MODE CHANGED.equals(action)){ 
boolean state = intent.getExtras().getBoolean("state"); 
if (state) { 
AirPlaneState("JT JA"); 
} else { 
AirPlaneState(" 关 闭 "); 


private void registerAirPlaneState Monitor(){ 
IntentFilter intentFilter = new IntentFilter(); 
intentFilter.addAction(Intent. ACTION AIRPLANE MODE CHANGED); 
context.registerReceiver(airPlaneStateReceiver, intentFilter); 


private void unregisterAirPlaneStateMonitor() { 
context.unregisterReceiver(airPlaneStateReceiver); 


@Override 
public void onDestroy() { 
unregisterA irPlaneStateMonitor(); 


@SimpleEvent(description = "反馈 飞行 模式 状态 ， 参 数值 为 开启 、 关 闭 ") 
public void AirPlaneState(String state) { 
EventDispatcher.dispatchEvent(this, "AirPlaneState", state); 


a 


@SimpleFunction(description = "获取 飞行 模式 状态 ， 返 回 值 为 开启 、 关 闭 '") 


public String GetAirPlaneState() { 


int state = Settings. System. getInt(context.getContentResolver(), Settings.System. 


AIRPLANE MODE ON, 0); 
if (state == 1){ 

return "开启 "; 
} else { 

return "关闭 "; 


j 


把 插件 导入 项 目 ， 并 添加 到 组 件 列表 后 ， 在 工作 面板 中 可 以 看 到 扣 
19-21 所 示 。 


工作 面板 
=f AirPlaneStatel1 = BED 


„state 
执行 


调用 COASA .GetAirPlaneState 
AirPlaneState1 ~ 


图 19-21 获取 和 监测 飞行 模式 状态 插件 函数 


19.6.2 ”插件 的 使 用 
使 用 示例 代码 如 图 19-22 所 示 。 


当 ED .被 单 击 
ATOUR we CEEE cowrponesee EBL ED | 
i) 调用 GHE 


(aW 调用 Gis .显示 消息 对 话 杠 


消息 


图 19-22 获取 和 监测 飞行 模式 状态 插件 使 用 代码 


19.7 系统 设置 插件 


§ 件 提供 的 函数 ， 如 


此 插件 用 于 从 用 户 操 作 的 当前 界面 跳 转 到 系统 设置 界面 ， 以 方便 用 户 进行 各 种 设置 。 


19.7.1 插件 的 实现 


在 存放 插件 源码 的 文件 夹 /appinventorcomponents/src/comy/qz/extensions 下 创建 源码 文件 


155 


SystemSettings.java， 其 中 的 代码 如 下 : 


756 


package com.systemsettings.extension; 


import android.content.Context; 

import android.util.Log; 

import com.google.appinventor.components.annotations.DesignerComponent; 
import com.google.appinventor.components.annotations.SimpleEvent; 

import com.google.appinventor.components.annotations.SimpleF unction; 
import com.google.appinventor.components.annotations.SimpleObject; 
import com.google.appinventor.components.common.ComponentCategory; 


import com.google.appinventor.components.runtime.*; 


import android.content.Context; 
import android.content.Intent; 
import android.provider.Settings; 


@DesignerComponent(version = SystemSettings. VERSION, 
description = "功能 ， 跳 转 到 系统 设置 界面 ”开发 者 : QZ", 
helpUrl = "http://blog.csdn.net/xjbelz", 
category = ComponentCategory.EXTENSION, 


nonVisible = true, 


iconName = "images/extension.png") 


@SimpleObject(external = true) 

public class SystemSettings extends AndroidNonvisibleComponent { 
public static final int VERSION = 1; 
private ComponentContainer container; 


private Context context; 


private static final String LOG_TAG = "SystemSettings"; 
public SystemSettings(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 


context = (Context) container.$context(); 


Log.d(LOG_TAG "SystemSettings Created" ); 


@SimpleFunction(description = "BEE ABW AIA") 
public void SystemSettings() { 
Intent intent = new Intent(Settings. ACTION SETTINGS); 
context.startA ctivity(intent); 


@SimpleFunction(description = " 跳 转 到 无 线 和 网 络 设置 界面 ") 
public void WirelessSettings() { 


Intent intent = new Intent(Settings. ACTION WIRELESS SETTINGS); 
context.startA ctivity (intent); 
} 
} 


把 插件 导入 项 目 ， 并 添加 到 组 件 列表 后 ， 在 工作 面板 中 可 以 看 到 插件 提供 的 函数 ， 如 
19-23 所 示 。 


工作 面板 


调用 .SystemSettings 
调用 temSettingsi ~ .WirelessSettings 


temSettings1 ~ 


图 19-23 系统 设置 插件 函数 


19.7.2 ”插件 的 使 用 


在 前 面 的 例子 中 ， 当 应 用 检测 到 设备 没有 连接 网 络 和 设备 处 于 飞行 模式 状态 时 ， 只 是 给 
用 户 提 示 ; 结合 此 插件 ， 可 以 从 应 用 界面 跳 转 到 系统 设置 界面 来 核查 网 络 设置 或 关闭 飞行 模 
式 ， 用 户 体验 更 好 。 
具体 代码 如 图 19-24 一 图 19-27 所 示 。 


当 GD 被 间 击 
aT | (2) MRP" iar CESE .GetNetworkState [EE 
Wo 调用 OCS .执行 GET 请 求 
= 


否则 调用 Gis .显示 选择 对 话 杠 
消息 
标题 

按钮 文本 
按钮 2 文本 


图 19-24 检测 设备 网 络 状态 


4 GEED .选择 完成 
访 振 值 
Oia) EL ea" | 


则 \ 调用 Systemsettings1 -WirelessSettings 


图 19-25 ”系统 设置 插件 使 用 代码 1 
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(用户 单 击 “ 确 定 ” 按 钮 ， 则 会 跳 转 到 无 线 和 网 络 设置 界面 ， 以 便 用 户 核查 网 络 设置 。) 


当 GD 被 间 击 
执行 (5) 如 果 | ART ‘GetAirPlaneState [ERS “ EID” 
则 J fakes 
All 调用 GHEE .显示 选择 对 话 杠 
消息 


标题 | “ 
按钮 文本 
按钮 2 文本 ELLE 
允许 撤销 0 


.SystemSettings 


BT 


图 19-27 系统 设置 插件 使 用 代码 2 
(用 户 单 击 “ 确 定 ” 按 钮 ， 则 会 跳 转 到 系统 设置 界面 ， 以 便 用 户 关 闭 飞 行 模式 。) 


19.8 ”列表 插件 


用 App Inventor 2 开发 应 用 的 时 候 ， 列 表 是 常 使 用 的 功能 模块 ， 但 系统 提供 的 列表 相关 
功能 不 全 面 ， 创 建 列表 的 方式 不 够 方便 灵活 ， 一 些 常用 功能 ， 如 列表 排序 ， 在 列表 中 查找 最 
大 值 、 最 小 值 的 功能 也 未 提供 。 

现 开发 一 个 插件 让 开发 人 员 能 够 比较 灵活 地 创建 列表 ， 以 及 提供 列表 排序 、 查 找 最 大 值 
和 最 小 值 的 功能 ， 上 其 体 实现 方式 如 下 。 


19.8.1 ”列表 创建 


使 用 以 下 函数 ， 开 发 人 员 可 以 把 字符 串 和 分 隔 符 作为 创建 列表 的 参数 ， 这 样 ， 只 需 一 行 
调用 此 函数 的 代码 ， 就 可 创建 列表 ， 非 常 方便 灵活 。 


@SimpleFunction(description = "把 包含 分 隔 符 的 字符 串 按 分 隔 符 分 解 ， 并 转 成 列表 
public static YailList ListCreate(String itemString, String separator) { 
YailList items = new YailList(); 
if (itemString.length() > 0) { 
items = YailList.makeList((Object[]) itemString.split(separator)); 
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return items; 


19.8.2 ”列表 排序 


Java 语言 提供 了 Collections 类 对 列表 进行 处 理 ， 功 能 强大 ， 且 使 用 非常 方便 。 但 App 
Inventor 2 使 用 的 列表 类 是 YailList， 需 要 先 把 YailList 列表 转换 成 标准 的 Java 列表 后 ， 再 使 
] Collections 类 进行 处 理 。 

Collections 类 对 数字 类 型 列表 和 非 数字 类 型 列表 的 处 理 方式 不 完全 一 样 ， 如 8 和 79 两 
个 数字 排序 ， 按 数字 类 型 处 理 79 比 8 大 ， 按 非 数 字 类 型 处 理 8 比 79 大 ， 这 样 代码 也 要 分 别 
实现 。 

排序 函数 的 代码 如 下 : 

@SimpleFunction(description = "列表 升序 排序 ") 
public YailList ListSort(YailList list, boolean isNumber) { 
if (lisNumber){ 
Object[] objectsArray = list.toArray(); 
java.util.List objectsList = Arrays.asList(objectsArray); 


java.util.Collections.sort(objectsList); 


return YailList.makeList(objectsList); 

} else { 
//int 和 float 类 型 都 可 以 看 成 是 double 的 子 类 ， 数 字 类 型 统一 按 double 类 型 处 理 
Object[] objectsArray = list.toArray(); 


java.util.List <Double> doublesArray = new ArrayList<Double>(); 


// 把 Object 数组 转 成 double 数组 
for(int i = 0; i < objectsArray.length; i++){ 
doublesArray.add(Double.parseDouble(objectsArray[i].toString())); 


SS 


java.util.Collections.sort(doublesArray); 


return YailList.makeList(doublesArray); 


} 


@SimpleFunction(description = "列表 降序 排序 ") 
public YailList ListReverse(YailList list, boolean isNumber) { 
if (lisNumber){ 
Object[] objectsArray = list.toArray(); 
java.util.List objectsList = Arrays.asList(objectsArray); 
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java.util.Collections.sort(objectsList); 
java.util.Collections.reverse(objectsList); 


return YailList.makeList(objectsList); 
} else { 
Object[] objectsArray = list.toArray(); 
java.util.List <Double> doublesArray = new ArrayList<Double>(); 
for(int i = 0; i < objectsArray. length; i++) { 
doublesArray.add(Double.parseDouble(objectsArray[i].toString())); 
java.util.Collections.sort(doublesArray); 


java.util.Collections.reverse(doubles Array); 


return YailList.makeList(doublesArray); 


19.8.3 ”列表 查找 


使 用 Collections 类 的 max 和 min 函数 ， 在 列表 中 查找 最 大 值 和 最 小 值 ， 对 数字 类 型 列 
表 和 非 数 字 类 型 列表 的 处 理 方 式 也 不 一 样 。 因 为 列表 元 素 的 类 型 不 确定 ， 所 以 函数 的 返回 值 
类 型 为 Object。 

查找 函数 的 代码 如 下 : 


TT 


@SimpleFunction(description = "列表 最 大 值 ") 
public Object ListMax(YailList list, boolean isNumber) { 
if (lisNumber){ 
Object[] objectsArray = list.toArray(); 
java.util.List objectsList = Arrays.asList(objectsArray); 
return java.util.Collections.max(objectsList); 
} else { 


Object[] objectsArray = list.toArray(); 
java.util.List <Double> doublesArray = new ArrayList<Double>(); 
for(int i = 0; i < objectsArray. length; i++) { 


doubles Array.add(Double.parseDouble(objectsArray[i].toString())); 


return java.util.Collections.max(doublesArray); 
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@SimpleFunction(description = "列表 最 小 值 ") 
public Object ListMin(YailList list, boolean isNumber) { 
if (lisNumber){ 
Object[] objectsArray = list.toArray(); 
java.util.List objectsList = Arrays.asList(objectsArray); 
return java.util.Collections.min(objectsList); 
} else { 
Object[] objectsArray = list.toArray(); 


java.util.List <Double> doublesArray = new ArrayList<Double>(); 
for(int i = 0; i < objectsArray.length; i++) { 


doublesArray.add(Double.parseDouble(objectsArray[i].toString())); 


return java.util.Collections.min(doublesArray); 


19.8.4 ”插件 的 实现 


在 存放 插件 源码 的 文件 夹 /appinventor/components/src/com/qz/extensions 下 创建 源码 文 伯 
QZList.java， 完 整 的 代码 如 下 : 


TT 


package com.qzlist.extension; 


import android.content.Context; 

import android.util.Log; 

import com.google.appinventor.components.annotations.DesignerComponent; 
import com.google.appinventor.components.annotations.SimpleEvent; 

import com.google.appinventor.components.annotations.SimpleF unction; 
import com.google.appinventor.components.annotations.SimpleObject; 
import com.google.appinventor.components.common.ComponentCategory; 
import com.google.appinventor.components.runtime.*; 


import com.google.appinventor.components.runtime.util. YailList; 


import android.content.Context; 
import java.util. Arrays; 

import java.util. ArrayList; 
import java.util.Collection; 


@DesignerComponent(version = QZList. VERSION, 
description = "功能 : 列表 处 理 ”开发 者 : QZ", 
helpUrl = "http://blog.csdn.net/xjbelz", 
category = ComponentCategory. EXTENSION, 
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nonVisible = true, 


ie 


iconName = "images/extension.png") 
@SimpleObject(external = true) 
public class QZList extends AndroidNonvisibleComponent { 
public static final int VERSION = 1; 
private ComponentContainer container; 


private Context context; 


private static final String LOG_TAG = "QZList"; 
public QZList(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 


context = (Context) container.$context(); 


Log.d(LOG_TAG "QZList Created" ); 


@SimpleFunction(description = "把 包含 分 隔 符 的 字符 串 按 分 隔 符 分 解 ， 
public static YailList ListCreate(String itemString, String separator) { 
YailList items = new YailList(); 
if (itemString.length() > 0) { 
items = YailList.makeList((Object[]) itemString.split(separator)); 


return items; 


@SimpleFunction(description = "列表 升序 排序 ") 
public YailList ListSort(YailList list, boolean isNumber) { 
if (lisNumber){ 
Object[] objectsArray = list.toArray(); 
java.util.List objectsList = Arrays.asList(objectsArray); 
java.util.Collections.sort(objectsList); 


return YailList.makeList(objectsList); 
} else { 
Object[] objectsArray = list.toArray(); 


java.util.List <Double> doublesArray = new ArrayList<Double>(); 


for(int i = 0; i < objectsArray.length; i++) { 


并 转 成 列表 " 


doublesArray.add(Double.parseDouble(objectsArray[i].toString())); 


java.util.Collections.sort(doublesArray); 


return YailList.makeList(doublesArray); 


@SimpleFunction(description = "列表 降序 排序 ") 
public YailList ListReverse(YailList list, boolean isNumber) { 
if (lisNumber){ 
Object[] objectsArray = list.toArray(); 
java.util.List objectsList = Arrays.asList(objectsArray); 


java.util.Collections.sort(objectsList); 


java.util.Collections.reverse(objectsList); 


return YailList.makeList(objectsList); 
} else { 
Object[] objectsArray = list.toArray(); 


java.util.List <Double> doublesArray = new ArrayList<Double>(); 


for(int i = 0; i < objectsArray.length; i++) { 
doublesArray.add(Double.parseDouble(objectsArray[i].toString())); 


java.util.Collections.sort(doublesArray); 
java.util.Collections.reverse(doubles Array); 


return YailList.makeList(doublesArray); 


@SimpleFunction(description = "列表 最 大 值 ") 
public Object ListMax(YailList list, boolean isNumber) { 
if (lisNumber){ 
Object[] objectsArray = list.toArray(); 
java.util.List objectsList = Arrays.asList(objectsArray); 
return java.util.Collections.max(objectsList); 
} else { 
Object[] objectsArray = list.toArray(); 


java.util.List <Double> doublesArray = new ArrayList<Double>(); 


for(int i = 0; i < objectsArray.length; i++) { 
doublesArray.add(Double.parseDouble(objectsArray[i].toString())); 
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return java.util.Collections.max(doublesArray); 


@SimpleFunction(description = "列表 最 小 值 ") 
public Object ListMin(YailList list, boolean isNumber) { 


if (!isNumber) { 


Object[] objectsArray = list.toArray(); 


java.util.List objectsList = Arrays.asList(objectsArray); 
return java.util.Collections.min(objectsList); 


} else { 


Object[] objectsArray = list.toArray(); 


java.util.List <Double> doublesArray = new ArrayList<Double>(); 


for(int i = 0; i < objectsArray. length; i++) { 


return java.util.Collections.min(doublesArray); 


} 


把 插件 导入 项 
图 19-28 和 图 19-29 所 示 。 


工作 面板 


调用 (YEE .ListCreate 
itemString 


separator 


调用 CERT .ListMax 


列表 


isNumber 
调用 .ListMin 
列表 


isNumber 


图 19-28 ”列表 插件 函数 1 


19.8.5 ”插件 的 使 用 


使 用 示例 代码 如 图 19-30 所 示 。 
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doubles Array.add(Double.parseDouble(objectsArray[i].toString())); 


目 ， 并 添加 到 组 件 列表 后 ， 在 工作 面板 中 可 以 看 到 插件 提供 的 函数 ， 如 


调用 QABA .ListReverse 


列表 


isNumber 


调用 .ListSort 
列表 


isNumber 


QZList1 ~ 


图 19-29 ”列表 插 伯 


函数 2 


当 -初始 化 
执行 ” 调用 GES Sneenisie 
消息 


调用 CHAD .显示 消息 对 话 框 
消息 


调用 GSD .显示 消息 对 话 框 
消息 


调用 CHAD . 显 示 消息 对 话 框 
消息 


19.9 代数 计算 插件 


App Inventor 2 的 数学 模块 提供 了 许多 功能 ， 但 未 提供 
个 插件 提供 矩阵 和 复数 计算 功能 。 


19.9.1 ”矩阵 的 运算 


列表 | 调用 -ListCreate 


isNumber ME E 


itemString 
separator 


调用 .ListCreate 


isNumber 个 


调用 .ListCreate 


itemString 
separator 


itemString mm 186509879 i 
separator ‘8° 


调用 .ListCreate 


t= 


isNumber » 5 


图 19-30 ”列表 插件 使 用 代码 


具体 实现 如 下 。 


itemString 186509879 i 
separator ‘8° 


和 矩阵 和 复数 计算 功能 ， 现 开发 一 


矩阵 运算 实现 了 和 矩阵 的 相 加 和 相 减 的 功能 。 无 论 是 几 维 和 矩阵， 都 可 以 表示 为 一 维 数组 ， 
也 就 是 可 以 使 用 列表 表示 矩阵， 在 App Inventor 2 中 就 是 YailList 列表 。 

数字 的 类 型 有 三 种 : int. float 和 double, int 和 float 可 以 看 成 是 double 的 子 集 因 不 确 
定 和 矩阵 元 素 的 类 型 ， 把 矩阵 元 素 的 类 型 定 为 double. 


和 矩阵 运算 函数 的 代码 如 下 : 


@SimpleFunction(description = "矩阵 相 加 由 
public YailList MatrixAdd(YailList list1, YailList list2) { 
java.util.List<Double> resultsList = new ArrayList<Double>(); 


Object[] objectsArray1 = listl.toArray(); 
Object[] objectsArray2 = list2.toArray(); 


if ((list1.sizeQ) == list2.size()) && (list1.sizeO > 0)){ 
for (int i = 0; i < listl.size(); i++) { 
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resultsList.add(new Double(objectsArray 1 [i].toString()) + new Double(objects 


Atray2[1].toString())); 
} 
return YailList.makeList(resultsList); 
} else { 
return null; 
} 


@SimpleFunction(description = "矩阵 相 减 由 
public YailList MatrixSub(YailList list1, YailList list2) { 
java.util.List<Double> resultsList = new ArrayList<Double>(); 


Object[] objectsArray1 = list] .toArray(); 
Object[] objectsArray2 = list2.toArray(); 


if ((list] .sizeQ) == list2.size()) && (list1.size() > 0)){ 
for (int i = 0; i < list1.sizeQ); 1++){ 
resultsList.add(new Double(objectsArray | [i].toString()) - new Double (objects 


Atray2[1].toString())); 
} 
return YailList.makeList(resultsList); 
} else { 
return null; 
} 


} 
相 加 和 相 减 函数 的 参数 类 型 都 是 YailList， 返 回 值 类 型 也 是 YailList。 
19.9.2 ”复数 的 运算 


复数 的 运算 实现 了 复数 的 加 、 减 、 乘 、 除 和 求 模 的 功能 。 因 不 确定 复数 实 部 和 虚 部 数字 
的 具体 类 型 ， 就 把 类 型 都 定 为 double。 
复数 的 运算 结果 包含 实 部 和 虚 部 两 个 变量 的 数值 ， 把 运算 结果 中 的 实 部 和 虚 部 作为 事件 
响应 函数 的 参数 ， 利 用 事件 响应 函数 返回 计算 结果 。 
复数 运算 函数 的 代码 如 下 : 
@SimpleFunction(description = "复数 运算 : +. -~ x, /") 
// operator 的 值 可 以 是 “+”、“-”、“x” 和 “/” 四 个 字符 ， 对 应 加 减 乘 除 运算 
public void Complex(double reall, double imagl, double real2, double imag2, String operator) { 
if (operator.equals("+")) { 


pun 


complexAdd(reall, imag1, real2, imag2); 
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if (operator.equals("-")) { 
complexSub(real1, imag1, real2, imag2); 


if (operator.equals("x")) { 
complexMul(reall, imag], real2, imag2); 


if (operator.equals("/")) { 
complexDiv(reall, imag], real2, imag2); 


ComplexResult(real, imag); 


@SimpleFunction(description = "复数 的 模 ") 
public double ComplexModel(double real, double imag) { 
return Math.sqrt(real * real + imag * imag); 


@SimpleEvent(description = "反馈 计算 结果 ") 
public void ComplexResult(double real, double imag) { 
EventDispatcher.dispatchEvent(this, "ComplexResult", real, imag); 


19.9.3 ”插件 的 实现 


在 存放 插件 源码 的 文件 夹 /appinventorcomponents/src/comy/qz/extensions 下 创建 源码 文人 
AlgebraicOperation.java， 代 人 码 如 下 : 


TT 


package com.algebraicoperation.extension; 


import android.content.Context; 

import android.util.Log; 

import com.google.appinventor.components.annotations.DesignerComponent; 
import com.google.appinventor.components.annotations.SimpleEvent; 

import com.google.appinventor.components.annotations.SimpleF unction; 
import com.google.appinventor.components.annotations.SimpleObject; 
import com.google.appinventor.components.common.ComponentCategory; 
import com.google.appinventor.components.runtime.*; 


import com.google.appinventor.components.runtime.util. YailList; 
import android.content.Context; 


import java.util. Arrays; 
import java.util. ArrayList; 
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import java.lang.String; 


@DesignerComponent(version = AlgebraicOperation. VERSION, 
description = "功能 : 代数 运算 ”开发 者 ， QZ", 
helpUrl = "http://blog.csdn.net/xjbelz", 
category = ComponentCategory. EXTENSION, 


nonVisible = true, 


iconName = "images/extension.png") 


@SimpleObject(external = true) 
public class AlgebraicOperation extends AndroidNonvisibleComponent { 
public static final int VERSION = 1; 
private ComponentContainer container; 
private Context context; 
private double real; 
private double imag; 


private static final String LOG_TAG = "AlgebraicOperation"; 
public AlgebraicOperation(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 


context = (Context) container.$context(); 
Log.d(LOG_TAG "AlgebraicOperation Created" ); 
@SimpleFunction(description = "矩阵 相 加 由 


public YailList MatrixAdd(YailList list1, YailList list2) { 
java.util. List<Double> resultsList = new ArrayList<Double>(); 


Object[] objectsArray1 = listl .toArray(); 
Object[] objectsArray2 = list2.toArray(); 


if ((list1.size() == list2.size()) && (listl .size() > 0)){ 
for (int i = 0; i < list1.sizeQ); 1++){ 
resultsList.add(new Double(objectsArray] [i].toString()) + new Double(objectsArray2[1]. 


toString())); 
} 
return YailList.makeList(resultsList); 
} else { 
return null; 
} 


@SimpleFunction(description = "FE KEAN") 
public YailList MatrixSub(YailList list1, YailList list2) { 
java.util.List<Double> resultsList = new ArrayList<Double>(); 


Object[] objectsArray1 = listl .toArray(); 
Object[] objectsArray2 = list2.toArray(); 


if ((list1.size() == list2.size()) && (list1.size() > 0)){ 
for (int i = 0; i < listl.size(); 1++){ 
resultsList.add(new Double(objectsArray1 [1].toString()) - new Double(objectsArray2[1]. 


toString())); 
} 
return YailList.makeList(resultsList); 
} else { 
return null; 
} 


@SimpleFunction(description = "复数 运算 : +. -~ x, /") 
public void Complex(double reall, double imag1, double real2, double imag2, String operator) { 
if (operator.equals("+")) { 
complexAdd(reall, imag1, real2, imag2); 


if (operator.equals("-")) { 
complexSub(real1, imag1, real2, imag2); 


if (operator.equals("x")) { 
complexMul(real1, imag], real2, imag2); 


if (operator.equals("/")) { 
complexDiv(reall, imag1, real2, imag2); 


ComplexResult(real, imag); 


@SimpleFunction(description = "复数 的 模 ") 
public double ComplexModel(double real, double imag) { 
return Math.sqrt(real * real + imag * imag); 
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@SimpleEvent(description = "反馈 计算 结果 ") 
public void ComplexResult(double real, double imag) { 
EventDispatcher.dispatchEvent(this, "ComplexResult", real, imag); 


public void complexAdd(double reall, double imag1, double real2, double imag2) { 
real = reall + real2; 
imag = imag] + imag2; 


public void complexSub(double reall, double imag1, double real2, double imag2) { 
real = reall - real2; 


imag = imag] - imag2; 


public void complexMul(double reall, double imag1, double real2, double imag2) { 
real = reall * real2 - imag * imag2; 
imag = imag] * real2 + reall * imag2; 


public void complexDiv(double reall, double imag1, double real2, double imag2) { 
real = (reall * real2 + imag * imag2) / (real2 * real2 + imag2 * imag2); 
imag = (imag! * real2 - reall * imag2) / (real2 * real2 + imag2 * imag2); 


} 


把 插件 导入 项 目 ， 并 添加 到 组 件 列表 后 ， 在 工作 面板 中 可 以 看 到 插件 提供 的 函数 ， 如 
19-31 和 图 19-32 所 示 。 
工作 面板 


=| AlgebraicOperation = oo 0 TE 


tilik AlgebraicOperation1 ~ KeS S 


real1 tli AlgebraicOperation1 ~ Eire \ele| 


list1 
list2 


imag1 
real2 
imag2 
operator 


:省 AlgebraicOperation1 ~ MEiurcie) 
list1 
list2 


Wl AlgebraicOperation1 ~ Kamo Se E 


real 


imag AlgebraicOperation1 ~ 


图 19-31 代数 计算 插件 函数 1 图 19-32 代数 计算 插件 函数 2 
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19.9.4 ”插件 的 使 用 
两 个 2X2 的 矩阵 相 加 减 的 代码 如 网 19-33 和 图 19-34 所 示 。 


初始 化 全 局 变量 EED 为 NO 创建 列表 ED 


Mets ase CED 为 MO) 创建 列表 


初始 化 全 局 变量 外 ) 为 人 (3) 创建 空 列表 


图 19-33 ”代数 计算 搬 件 使 用 代码 1 


aA AA .MatrixAdd 
list! (BX 
list2 及 取 
设置 为 ， 调用 .MatrixSub 
list | BR 
list2 (BR 


图 19-34 ”代数 计算 搬 件 使 用 代码 2 


复数 运算 的 代码 如 图 19-35 和 图 19-36 所 示 。 


Fi: AlgebraicOperation1 = Re.. Eh 


reall 
imag1 
real2 
imag2 
operator 


=| AlgebraicOperation1 = Ksm 0 T 


图 19-35 ”代数 计算 搬 件 使 用 代码 3 
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当 ES .被 单 击 
HI 设置 UED . eZI 为 WA .ComplexModel 


real | 


imag | 


图 19-36 ”代数 计算 插件 使 用 代码 4 


19.10 ”几何 计算 插件 
App Inventor 2 的 数学 模块 未 提供 计算 图 形 面积 和 体积 的 功能 ， 现 开发 一 个 插件 提供 这 
两 种 功能 。 有 具体 实现 如 下 。 
19.10.1 计算 图 形 的 面积 
长 方形 和 正方 形 统一 使 用 和 矩形 表示 ， 面 积 计算 方式 ， 宽度 X 高 度 。 
三 角形 的 面积 有 多 种 计算 方式 ， 此 插件 实现 了 两 种 : 
© 面积 = 底 X 高 /2; 
© 面积 = 边 长 1X 边 长 2X 两 边 间 的 夹 角 的 正弦 值 /2。 
长 方 体 和 正方 体 统一 使 用 立方 体 表 示 ， 表 面积 计算 方式 ， KE X 宽度 X2+ 长 度 X 高 度 X 
2+ 宽 度 X 高 度 X2。 
19.10.2 ”计算 图 形 的 体积 
长 方 体 和 正方 体 统 一 使 用 立方 体 表示 ， 体 积 计算 方式 ， KE X 宽度 X 高 度 。 
19.10.3 ”插件 的 实现 


在 存放 插件 源码 的 文件 夹 /appinventor/components/src/com/qz/extensions 下 创建 源码 文件 
GeometricOperation.java， 代 人 码 如 下 : 


ij 


package com.geometricoperation.extension; 


import android.content.Context; 

import android.util.Log; 

import com.google.appinventor.components.annotations.DesignerComponent; 
import com.google.appinventor.components.annotations.SimpleEvent; 

import com.google.appinventor.components.annotations.SimpleFunction; 
import com.google.appinventor.components.annotations.SimpleObject; 
import com.google.appinventor.components.common.ComponentCategory; 
import com.google.appinventor.components.runtime.*; 


import com.google.appinventor.components.runtime.util. YailList; 


import android.content.Context; 
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import java.util.Arrays; 
import java.util. ArrayList; 


import java.lang.String; 


@DesignerComponent(version = GeometricOperation. VERSION, 
description = "功能 : 几何 运算 ”开发 者 ;QZ"， 
helpUrl = "http://blog.csdn.net/xjbelz", 
category = ComponentCategory. EXTENSION, 


nonVisible = true, 


iconName = "images/extension.png") 


@SimpleObject(external = true) 

public class GeometricOperation extends AndroidNonvisibleComponent { 
public static final int VERSION = 1; 
private ComponentContainer container; 


private Context context; 


private static final String LOG_TAG = "GeometricOperation"; 
public GeometricOperation(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 


context = (Context) container.$context(); 


Log.d(LOG_TAG, "GeometricOperation Created" ); 


@SimpleFunction(description = "FEZ HAR") 
public double RectangularArea(double width, double height) { 
return (width * height); 


@SimpleFunction(description = "三 角形 面积 ") 
public double TriangleArea(double bottom, double height) { 
return (bottom * height / 2); 


@SimpleFunction(description = "三 角形 面积 ") 
public double TriangleArea2(double sideLength1, double sideLength2, double angle) { 
return (sideLength! * sideLength2 * Math.sin(angle)/ 2); 


PA 


@SimpleFunction(description = " 圆 形 面积 ") 
public double CircularArea(double radius, double pi) { 
return (pi * radius * radius); 


173 


局] 


@SimpleFunction(description = "椭圆 面积 ") 
public double EllipticalArea(double longAxis, double shortAxis, double pi) 
return (pi * longAxis * shortAxis / 4); 


@SimpleFunction(description = "梯形 面积 ") 
public double TrapezoidalArea(double top, double bottom, double height) { 
return ((top + bottom) * height / 2); 


@SimpleFunction(description = "立方 体 表面 积 ") 
public double CubicArea(double length, double width, double height) { 
return (length * width * 2 + length * height * 2 + width * height * 2); 


@SimpleFunction(description = "立方 体 体积 ") 
public double CubicVolume(double length, double width, double height) { 
return (length * width * height); 


pan 


柱 体 表面 积 ") 
public double CylinderArea(double radius, double height, double pi) { 
return (pi * radius * radius * 2 + pi * radius * 2 * height); 


@SimpleFunction(description = " 


@SimpleFunction(description = "圆柱 体 体积 ") 
public double Cylinder Volume(double radius, double height, double pi) { 
return (pi * radius * radius * height); 


@SimpleFunction(description = "球体 表面 积 ") 
public double SphereArea(double radius, double pi) { 


return (pi * radius * radius * 4); 


@SimpleFunction(description = "球体 体积 ") 
public double SphereVolume(double radius, double pi) { 
return ((pi * radius * radius * radius * 4) / 3); 


} 


{ 


巴 插件 导入 项 目 ， 并 添加 到 组 件 列 表 后 ， 在 工作 面板 中 可 以 看 到 操 
图 19-37 一 图 19-40 所 示 。 
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PEE PEAS RK Z LI 


工作 面板 


1 省 GeometricOperation1 ~ Keran Ei 
半径 
pi 


lii GeometricOperation| ~ Ken IAEA] 
length 


宽度 


高 度 


li:i GeometricOperation1 ~ Roe/ TWS 
length 


宽度 


调用 .CylinderArea 
半径 

高 度 

pi 


ij 省 GeometricOperation1 ~ Keyin. CAOILE 
半径 


高 度 

pi 
让 :省 GeometricOperation1 = MSALI NE 
longAxis 
shortAxis 


pi 


图 19-38 ”几何 计算 插件 函数 2 


高 度 


图 19-37 ”几何 计算 插件 函数 1 
调用 .RectangularArea 


il:i GeometricOperation1 = EYIDA EE 
半径 
pi 


tli GeometricOperation1 ~ PEW. EAEE] 


bottom 


高 度 


i-li GeometricOperation| ~ ESIN OITUA 
半径 
pi 


nal: GeometricOperation( = aie | e=72e)(e Fre) 


调用 -TriangleArea2 
sideLength1 

sideLength2 

角度 


top 
bottom 


高 度 


图 19-39 ”几何 计算 插件 函数 3 


GeometricOperation| X 


图 19-40 ”几何 计算 插件 函数 4 


19.11 手电 简 功 能 插件 


此 插件 是 利用 移动 设备 上 的 闪光 灯 实 现 手 电 简 功能 。 具 体 实现 如 下 。 
19.11.1 插件 的 实现 


在 存放 插件 源码 的 文件 夹 /appinventorcomponents/src/comy/qz/extensions 下 创建 源码 文人 
P 的 代码 如 下 : 


TT 


imi 


Torch.java, 


package com.torch.extension; 


import android.content.Context; 

import android.util.Log; 

import com.google.appinventor.components.annotations.DesignerComponent; 
import com.google.appinventor.components.annotations.SimpleEvent; 

import com.google.appinventor.components.annotations.SimpleFunction; 
import com.google.appinventor.components.annotations.SimpleObject; 
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import com.google.appinventor.components.annotations.UsesPermissions; 
import com.google.appinventor.components.common.ComponentCategory; 


import com.google.appinventor.components.runtime.*; 


import android.content.Context; 
import android.content. Intent; 
import android.hardware.Camera; 


import android.hardware.Camera.Parameters; 


@DesignerComponent(version = Torch. VERSION, 
description = "功能 : 手电 简 FRÆ: QZ", 
helpUrl = "http://blog.csdn.net/xjbelz", 
category = ComponentCategory.EXTENSION, 


nonVisible = true, 


iconName = "images/extension.png") 


@SimpleObject(external = true) 
/申请 使 用 CAMERA 和 闪光 灯 的 系统 权限 
@UsesPermissions(permissionNames = "android.permission.CAMERA, android.permission. FLASHLIGHT") 
public class Torch extends AndroidNonvisibleComponent implements OnDestroyListener { 
public static final int VERSION = 1; 


private ComponentContainer container; 


private Context context; 


private Camera camera; 


private static final String LOG_TAG = "Torch"; 
public Torch(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 
context = (Context) container.$context(); 


Log.d(LOG_TAG "Torch Created" ); 


/销毁 当前 界面 时 ， 关 闭 CAMERA 
@Override 
public void onDestroy() { 


if(camera != null) { 
camera.stopPreview(); 


camera.release(); 


Tm 


@SimpleFunction(description = "打开 手电 简 ") 


public void TorchOn() { 


camera = Camera.open(); 


Parameters params = camera.getParameters(); 


params.setF lashMode(Parameters. FLASH MODE TORCH); 


camera.setParameters(params); 
camera.startPreview(); 


} 


@SimpleFunction(description = "X HF EH") 


public void TorchOff() { 
if(camera != null) { 


Parameters params = camera.getParameters(); 


params.setFlashMode(Parameters. FLASH MODE OFF); 


camera.setParameters(params); 


camera.startPreview(); 


j 


把 插件 导入 项 目 ， 并 添加 到 组 件 列表 后 ， 在 工作 面板 中 可 以 看 到 所 


19-41 所 示 。 


工作 面板 


调用 .TorchOff 


调用 .TorchOn 


图 19-41 


19.11.2 ”插件 的 使 用 
示例 代码 如 图 19-42 所 示 。 


FH 


E tit 


洋 


调用 .TorchOn 
CRAE 


否则 | 调用 .TorchOff 
BE 【按钮 1 . 文本 ~ Ea 


图 19-42 


FH 


已 简 插 人 


F 使 用 代码 


§ 件 提供 的 函数 ， 如 
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Im- 


6 击 按钮 打开 和 关闭 手电 简 的 时 候 ， 按 钮 上 的 文字 在 “打开 ”和 “关闭 ” 间 切 换 。 


19.12 手机 号 码 校 验 插件 


App Inventor 2 提供 了 发 短信 和 拨打 电话 的 功能 ， 但 没有 提供 对 电话 号 人 码 进行 验证 的 功 
能 ; 目前 大 多 数 应 用 在 发 短信 和 拨打 电话 号 人 码 的 时 候 ， 都 会 对 手机 号 码 进行 验证 ， 以 应 对 用 
户 输 错 手机 号 人 码 之 类 的 情况 。 现 开发 一 个 插件 提供 上 述 功 能 ， 具 体 实 现 方式 如 下 。 
19.12.1 ”插件 的 实现 


在 存放 插件 源码 的 文件 夹 /appinventor/components/src/com/qz/extensions 下 创建 源码 文 伯 
MobilePhoneNumber.java， 其 中 的 代码 如 下 : 


TT 


package com.mobilephonenumber.extension; 


import android.content.Context; 

import android.util.Log; 

import com.google.appinventor.components.annotations.DesignerComponent; 
import com.google.appinventor.components.annotations.SimpleEvent; 

import com.google.appinventor.components.annotations.SimpleF unction; 
import com.google.appinventor.components.annotations.SimpleObject; 
import com.google.appinventor.components.common.ComponentCategory; 


import com.google.appinventor.components.runtime.*; 
import android.content.Context; 


@DesignerComponent(version = MobilePhoneNumber. VERSION, 
description = "功能 : 验证 手机 号 码 格式 ”开发 者 : QZ", 
helpUrl = "http://blog.csdn.net/xjbelz", 
category = ComponentCategory.EXTENSION, 
nonVisible = true, 


= 


images/extension.png") 


J 


iconName 


@SimpleObject(external = true) 

public class MobilePhoneNumber extends AndroidNonvisibleComponent { 
public static final int VERSION = 1; 
private ComponentContainer container; 


private Context context; 


private static final String LOG_TAG = "MobilePhoneNumber"; 
public MobilePhoneNumber(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 


context = (Context) container.$context(); 


Log.d(LOG_TAG "MobilePhoneNumber Created" ); 
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j 


@SimpleFunction(description = "验证 手机 号 码 格式 是 否 正 确 ， 返 回 值 为 tue 或 false") 
public boolean IsMobilePhoneNumber(String phoneNumber) { 

// 用 于 校 验 手机 号 码 的 正则 表达 式 

String phoneNumberRegularExpression = "[1][3578]\\d{9}"; 


if (phoneNumber == null || phoneNumber.length() != 11) 
{ 


return false; 


} 


return phoneNumber.matches(phone NumberRegularExpression); 


} 


把 插件 导入 项 目 ， 并 添加 到 组 件 列表 后 ， 在 工作 面板 中 可 以 看 到 插件 提供 的 函数 ， 如 
19-43 所 示 。 


工作 面板 


Wil; MobilePhoneNUmber1 = PAVOS ATININ Tg 
PhoneNumber 


MobilePhoneNumber1 ~ 


图 19-43 手机 号 码 校 验 插件 函数 


19.12.2 ”插件 的 使 用 
示例 代码 如 图 19-44 所 示 。 


ne 
ui 省 MobilePhoneNumber1 ~ -IsMobilePhoneNumber 


PhoneNumber 文本 输入 杠 


否则 调用 GHHD .显示 警告 信息 
< 通知 


图 19-44 手机 号 码 校 验 插件 使 用 代码 


19.13 ”判断 应 用 是 否 第 一 次 运行 插件 


许多 应 用 在 用 户 第 一 次 使 用 的 时 候 ， 会 显示 欢迎 界面 、 使 用 说 明之 类 的 信息 和 设置 某 些 
参数 的 值 ， 这 就 需要 判断 应 用 是 否 是 第 一 次 运行 。 
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HH 


在 App Inventor 2 中 ， 可 以 参照 微 数据 库 组 件 ， 利 用 Android 系统 的 SharedPreferences 框 


架 ， 把 标识 应 用 是 否 第 一 次 运行 的 变量 值 保 存在 xml 文件 


断 应 用 是 否 第 一 次 运行 。 


体 实现 方式 如 下 。 


19.13.1 ”插件 的 实现 


在 存放 插件 源码 的 文件 夹 /appinventor/components/src/com/qz/extensions 下 创建 源码 文 伯 


imi 


FirstRun.java， 其 中 的 代码 如 下 : 
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package com.firstrun.extensions; 


import android.content.Context; 

import android.util.Log; 

import com.google.appinventor.components.annotations.*; 

import com.google.appinventor.components.common.ComponentCategory; 
import com.google.appinventor.components.runtime.*; 


import com.google.appinventor.components.runtime.util.*; 


import com.google.appinventor.components.runtime.errors. YailRuntimeError; 
import android.content.SharedPreferences; 
import org.json.JSONException; 


@DesignerComponent(version = FirstRun. VERSION, 
description = "功能 : 判断 App 是 否 第 一 次 运行 ”开发 者 : QZ", 
helpUrl = "http://blog.csdn.net/xjbelz", 
category = ComponentCategory.EXTENSION, 


nonVisible = true, 


iconName = "images/extension.png") 


@SimpleObject(external = true) 
public class FirstRun extends AndroidNonvisibleComponent implements Component { 
public static final int VERSION = 1; 
private ComponentContainer container; 
private Context context; 
private SharedPreferences sharedPreferences; 
private final String tag = "FirstRun"; 
private static final String LOG_TAG = "FirstRun"; 


public FirstRun(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 
context = (Context) container.$context(); 
Log.d(LOG_TAG "FirstRun Created" ); 


sharedPreferences = context.getSharedPreferences("FirstRun", Context MODE PRIVATE); 


， 通 过 读 取 xml 文件 中 的 数值 判 


TT 


5i 


@SimpleFunction(description = "判断 App 是 否 第 一 次 运行 ， 值 为 true 或 false”) 
/从 xml 文件 中 读 取 的 字符 串 值 为 yes， 则 App 是 第 一 次 运行 ， 函 数 返 回 值 为 true， 和 否则 返回 
// 值 为 false 
public boolean IsFirstRun() { 
if (GetValue(tag, "yes") == "yes") { 
StoreValue(tag, "no"); 


return true; 
}else{ 
return false; 


@SimpleFunction(description = "清除 记录 是 否 第 一 次 运行 的 标识 

public void ClearFirstRunFlag() { 
final SharedPreferences.Editor sharedPrefsEditor = sharedPreferences.edit(); 
sharedPrefsEditor.clear(); 
sharedPrefsEditor.commit(); 


/从 xml 文件 中 读 取 数值 
public Object GetValue(final String tag, final Object valuelfTagNotThere) { 
try { 
String value = sharedPreferences. getString(tag, ""); 
return (value.length() = 0) ? valuelfTagNotThere : JsonUtil.getObjectFromJson(value); 
} catch (SSONException e) { 
throw new YailRuntimeError("Value failed to convert from JSON.", "JSON Creation Error."); 


} 


HJ 


TT 


/保存 数值 到 xml 3044 
public void StoreValue(final String tag, final Object valueToStore) { 
final SharedPreferences.Editor sharedPrefsEditor = sharedPreferences.edit(); 
try { 
sharedPrefsEditor.putString(tag, JsonUtil.getJsonRepresentation(valueToStore)); 
sharedPrefsEditor.commit(); 
} catch (SSONException e) { 
throw new YailRuntimeError("Value failed to convert to JSON.", "JSON Creation Error."); 
j 
j 
} 


把 插件 导入 项 目 ， 并 添加 到 组 件 列表 后 ， 在 工作 面板 中 可 以 看 到 插件 提供 的 函数 ， 如 
图 19-45 所 示 。 
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工作 面板 


调用 .ClearFirstRunFlag 


调用 GEG .lsFirstRun 


图 19-45 判断 应 用 是 否 第 一 次 运行 插件 函数 


19.13.2 ”插件 的 使 用 
示例 代码 如 图 19-46 所 示 。 


当 .初始 化 
调用 .lsFirstRun | ERS) ED 


图 19-46 判断 应 用 是 否 第 一 次 运行 插件 使 用 代码 
如 果 应 用 是 第 一 次 运行 ， 就 显示 一 张 “ 欢 迎 jpg” 图 片 。 


19.14 ”获取 定位 功能 状态 插件 


定位 功能 属于 常用 功能 ，App Inventor 2 也 提供 了 “位 置 传感器 ”组 件 ， 但 需要 用 户 打 
开设 备 的 定位 功能 ,“ 位 置 传感器 ”组 件 才 能 正常 使 用 。 在 使 用 “位 置 传感器 ”组 件 的 时 
候 ， 最 好 先 获 取 设 备 当前 的 定位 功能 状态 ， 如 果 定 位 功能 没有 打开 ， 则 提示 用 户 是 否 打开 定位 
功能 。App Inventor 2 没有 提供 获取 定位 功能 状态 的 组 件 ， 需 要 自行 开发 ， 具 体 实现 如 下 。 


19.14.1 ”插件 的 实现 


在 存放 插件 源码 的 文件 夹 /appinventor/components/src/com/qz/extensions 下 创建 源码 文件 
LocationState.java， 其 中 的 代码 如 下 : 


T 


package com.locationstate.extension; 


import android.content.Context; 

import android.util.Log; 

import com.google.appinventor.components.annotations.DesignerComponent; 
import com.google.appinventor.components.annotations.SimpleEvent; 

import com.google.appinventor.components.annotations.SimpleFunction; 
import com.google.appinventor.components.annotations.SimpleObject; 
import com.google.appinventor.components.annotations.UsesPermissions; 
import com.google.appinventor.components.common.ComponentCategory; 
import com.google.appinventor.components.runtime.*; 
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位 功 


import android.location.LocationManager; 


@DesignerComponent(version = LocationState. VERSION, 
description = "功能 :获取 定位 功能 状态 ”开发 者 : QZ", 
helpUrl = "http://blog.csdn.net/xjbelz", 
category = ComponentCategory.EXTENSION, 


nonVisible = true, 
iconName = "images/extension.png") 


@SimpleObject(external = true) 
@UsesPermissions(permissionNames = "android.permission. ACCESS FINE LOCATION") 
public class LocationState extends AndroidNonvisibleComponent { 

public static final int VERSION = 1; 

private ComponentContainer container; 


private Context context; 


private static final String LOG_TAG = "LocationState"; 
public LocationState(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 


context = (Context) container.$context(); 


Log.d(LOG_TAG "LocationState Created" ); 


@SimpleFunction(description = "获取 定位 功能 状态 ， 返 回 值 为 开启 或 关闭 
public String GetLocationState() { 
LocationManager locationManager = (LocationManager) context.getSystemService 
(Context. LOCATION_SERVICE); 
/ 通过 GPS 卫星 定位 ， 适 用 于 在 室外 定位 
boolean gpsProvider = locationManager.isProviderEnabled(LocationManager.GPS_ PROVIDERJ); 
/ 通过 基站 或 WIFI 定位 ， 室 内 室外 都 可 用 
boolean networkProvider = locationManager.isProviderEnabled(LocationManager.NETWORK _ 
PROVIDER); 
if (gpsProvider || networkProvider) { 
return "FF JA"; 


return "关闭 "; 


} 


“位 置 传感器 ”组 件 文 持 GPS、 基 站 或 WIFI 定位 ， 所 以 只 要 用 户 打 开 其 中 任意 一 种 定 


ab 


He 


,“ 位 置 传感器 ”组 件 都 可 正常 使 用 。 


Li 


插件 导入 项 目 ， 并 添加 到 组 件 列表 后 ， 在 工作 面板 中 可 以 看 到 插件 提供 的 函数 ， 如 
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19-47 所 示 。 
工作 面板 
调用 .GetLocationState 


LocationState1 = 


图 19-47 ”获取 定位 功能 状态 插件 函数 


19.14.2 ”插件 的 使 用 
示例 代码 如 图 19-48 所 示 。 


否则 调用 CHAD .显示 选择 对 话 框 


消息 


CMR susie (Ee ED a’ 
则 \ 调 用 CE SystemSettings 


图 19-48 ”获取 定位 功能 状态 插件 使 用 代码 

在 启动 “位 置 传感器 ”组 件 之 前 ， 调 用 此 插件 获取 定位 功能 状态 ， 如 果 没 有 开局， 则 显 
示 选 择 提示 框 ， 提 示 用 户 是 否 开启 定位 功能 ， 如 果 用 户 单 击 确定 按钮 ， 则 调用 系统 设置 插 
件 ， 跳 转 到 系统 设置 界面 ， 以 便 用 户 开启 定位 功能 。 


19.15 创建 JSON 字符 串 插件 


目前 应 用 和 服务 器 间 传 输 数据 大 多 采用 JSON 格式 的 数据 ，App Inventor 2 提供 了 解析 
JSON 格式 数据 的 功能 函数 ， 但 没有 提供 创建 JSON 格式 数据 的 功能 函数 ， 需 要 自行 开发 创 
建 JSON 格式 数据 的 插件 ， 具 体 实现 如 下 。 


19.15.1 ”插件 的 实现 


在 存放 插件 源码 的 文件 夹 /appinventorcomponents/src/com/qz/extensions 下 创建 源码 文件 
JSONCreatejava， 其 中 的 代码 如 下 ; 


package com.jsoncreate.extension; 


import android.content.Context; 
import android.util.Log; 
import com.google.appinventor.components.annotations.DesignerComponent; 
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import com.google.appinventor.components.annotations.SimpleEvent; 
import com.google.appinventor.components.annotations.SimpleF unction; 
import com.google.appinventor.components.annotations.SimpleObject; 
import com.google.appinventor.components.annotations. UsesPermissions; 
import com.google.appinventor.components.common.ComponentCategory; 


import com.google.appinventor.components.runtime.*; 


import org.json.JSONException; 
import org.json.JSONObject; 


@DesignerComponent(version = JSONCreate. VERSION, 
description = "功能 : 创建 ISON FE FFA: QZ", 
helpUrl = "http://blog.csdn.net/xjbelz", 
category = ComponentCategory.EXTENSION, 


nonVisible = true, 


iconName = "images/extension.png") 


@SimpleObject(external = true) 
public class JSONCreate extends AndroidNonvisibleComponent { 
public static final int VERSION = 1; 
private ComponentContainer container; 
private Context context; 
private JSONObject obj; 


private static final String LOG_TAG = "JSONCreate"; 
public JSONCreate(ComponentContainer container) { 
super(container.$form()); 
this.container = container; 


context = (Context) container.$context(); 


Log.d(LOG TAG, "JSONCreate Created" ); 


@SimpleFunction(description = "创建 JSON 对 象 ") 
public void CreateJSONObject() { 
obj = new JSONObject(); 


@SimpleFunction(description = "添加 boolean 类 型 元 素 ") 
public void PutBooleanValue(String name, boolean booleanValue) { 
try { 
obj.put(name, boolean Value); 
}catch (JSONException e) 
{ 


e.printStackTrace(); 
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@SimpleFunction(description = "添加 double ŽALICA") 
public void PutDoubleValue(String name, double doubleValue) { 
try { 
obj.put(name, doubleValue); 
}catch (JSONException e) 
{ 


e.printStackTrace(); 


@SimpleFunction(description = "添加 int 类 型 元 素 ") 
public void PutIntValue(String name, int intValue) { 
try { 
obj.put(name, intValue); 
}catch (JSONException e) 
{ 


e.printStackTrace(); 


@SimpleFunction(description = "添加 long 类 型 元 素 ") 
public void PutLongValue(String name, long longValue) { 
try { 
obj.put(name, longValue); 
}catch (JSONException e) 
{ 


e.printStackTrace(); 


@SimpleFunction(description = "添加 Object 类 型 元 素 ") 
public void PutObjectValue(String name, Object objectValue) { 
try { 
obj.put(name, objectValue); 
}catch (JSONException e) 
{ 


e.printStackTrace(); 


@SimpleFunction(description = " 移 除 元 素 ") 
public void Remove(String name) { 


obj.remove(name); 
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@SimpleFunction(description = "把 JSON 格式 数据 转 成 String 类 型 数据 
public String JSONtoString() { 
return String.valueOf(obj); 


} 


T 


把 插件 导入 项 目 ， 并 添加 到 组 件 列 表 后 ， 在 工作 面板 中 可 以 看 到 插件 提供 的 函数 ， 如 
19-49 和 图 19-50 所 示 。 


工作 面板 


调用 JSONCreatel ~ .CreateJSONObject 


til JSONCreatel > JSONtoString 


调用 ENA .PutLongValue 
名 称 


longValue 


调用 ENAA .PutBooleanValue 
名 称 


booleanValue 
调用 ENARA .PutObjectValue 
名 称 


objectValue 


调用 ENAA .PutDoubleValue 
名 称 


doubleValue 


调用 JSONCreatel .Remove 
调用 JSONCreatel ~ .PutlntValue 


名 称 
intValue JSONCreate1 ~ 


图 19-49 ”创建 ISON 字符 是 


名 称 


ud 


插件 函数 1 图 19-50 ”创建 ISON 字符 串 插件 函数 2 


19.15.2 ”插件 的 使 用 
示例 代码 如 图 19-51 所 示 。 


[9] EXD GE i = 
执行 语句 | 调用 .CreateJSONObject 
| 调用 PutObjectValue 
名 称 
objectValue ! 
调用 -PutDoubleValue 
名 称 


doubleValue 


| 调用 .PutintValue 
名 称 | “ 
intValue 
| 调用 PutBooleanValue 


名 称 
booleanValue MEES 
调用 CIES .执行 POST 文本 请 求 
ee 文本 | 调用 .JSONtoString 


图 19-51 创建 ISON 字符 串 插 件 使 用 代码 
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上 述 代 码 创 建 并 向 服务 器 发 送 如 下 JSON 字符 串 : 
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第 20 章 综合 实例 开发 


20.1 抓 青蛙 游戏 


20.1.1 ”游戏 简介 


点 赞 。 


抓 青 蛙 游 戏 的 玩法 : 有 只 青蛙 在 草地 上 跳 来 路 去 ， 当 玩家 用 手指 单 击 青蛙 时 ， 就 抓 住 了 
青蛙 ， 同 时 积分 加 1， 每 局 的 时 间 为 30s。 
游戏 结束 时 ， 如 果 积 分 达到 或 超过 了 20 分 ， 会 在 界面 上 显示 一 个 点 赞 的 图 标 ， 给 玩家 


玩家 可 以 设置 开启 或 关闭 游戏 的 背景 音乐 ， 默 认 开 启 ; 也 可 以 查看 自己 的 积分 记录 。 
20.1.2 ”游戏 使 用 的 素材 


使 


的 素材 如 图 20-1 所 示 。 


素材 


caodi.png 
dianzan.png 
music.mid 


qingwa.png 


图 20-1 抓 青蛙 游戏 使 用 的 素材 


caodi.png 一 一 草地 图 片 ; 
dianzan.png RARE 


music.mid 


qingwa.png 一 一 青蛙 图 片 ， 也 用 做 应 用 在 系统 桌面 显示 的 Icon 图 片 。 
20.1.3 ”游戏 使 用 的 插件 


使 用 的 插件 如 图 20-2 所 示 。 
BatteryState 监测 设备 电量 状态 插件 ; 
AirPlaneState 获取 和 监测 设备 飞行 模式 状态 插件 ; 
QZList 列表 插件 ; 

FirstRun 判断 应 用 是 否 第 一 次 运行 插件 ; 
NetworkState 获取 和 监测 设备 网 络 状态 插件 ; 


189 


SystemInfo 获取 设备 和 系统 信息 插件 ; 
SystemSettings 系统 设置 插件 。 
Extension 


| Import extension 


BatteryState 
AirPlaneState 


QZList 


NetworkState 


Systemlnfo 


+ 
* 
4 
WẸ ”FirstRun 
+ 
+ 


SystemSettings 


20.1.4 ”游戏 实现 


1. 屏幕 界面 
此 游戏 有 三 个 屏幕 : 主屏 幕 (Screen1)、 设 
的 屏幕 (Screen3)。 


图 20-2 ” 抓 青 晨 游 戏 使 用 的 插件 


置 背景 音 的 屏幕 〈Screen2) 和 查看 积分 记录 


20-3 为 游戏 未 开始 时 的 主屏 幕 界面 ， 图 20-4 是 游戏 进行 中 的 主屏 幕 界面。 


OG AMS 游戏 3 


图 20-3” 抓 青蛙 游戏 主屏 幕 界面 1 
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图 20-4 抓 青 蛙 游 戏 主 屏幕 界面 2 


20-5 是 游戏 结束 时 ， 积 分 小 于 20 时 的 主屏 幕 界面 ， 图 20-6 是 积分 大 于 20 时 显示 的 
主屏 幕 界 面 。 


BY Bis ORD 


2 


SRS OD 


图 20-5 ” 抓 青蛙 游戏 主屏 幕 界面 3 


图 20-6 抓 青蛙 游戏 主屏 幕 界面 4 
主屏 幕 有 “退出 ” “关于 ” “设置 ” 和 “g 


x 


所 版 本 ”四 个 功能 菜单 ， 如 图 20-7 所 示 。 
图 20-8 是 单 击 “ 退 出 ”菜单 显示 的 界面 ， 图 20-9 是 单 击 “ 关 于 ”菜单 显示 的 界面 。 


WADE ATS MK l 


ip 提示 


确定 要 退出 应 用 ? 


图 20-7 抓 青蛙 游戏 主屏 幕 功 能 菜 旧 


图 20-8 单 击 “退出 ”菜单 显示 的 界 卫 
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ei 关于 


抓 青蛙 v1.0 


梦幻 工作 室 2018 


图 20-9 单 击 “ 关 于 ”菜单 显示 的 界面 


单 击 “ 设 置 ”菜单 ， 会 打开 设置 背景 音 的 屏幕 ， 单 击 “ 更 新 版 本 ”菜单 ， 会 打开 一 个 
网 页 。 


图 20-10 为 设置 背景 音 的 屏幕 界面 ， 图 20-11 为 查看 积分 记录 的 屏幕 界面 ， 这 两 个 屏幕 
都 有 “退出 ”和 “关于 ”两 个 功能 菜单 。 


“il B 5:19 
积分 排行 榜 


开启 背景 音乐 © 23 

关闭 背景 音乐 © 14 
13 
11 
10 
2 


退出 tF 


图 20-10 设置 背景 音 的 屏幕 界面 图 20-11 查看 积分 记录 的 屏幕 界面 


| 


2. 主屏 幕 界面 及 功能 实现 
1) 界面 布局 如 图 20-12 所 示 。 
2) 界面 使 用 的 组 件 列表 ， 如 图 20-13 所 示 。 


组 件 列表 


S| Screen] 

A 数据 显示 

.草地 

园 功能 标签 水 平 布局 
A 对 话 框 1 
O 游戏 时 间 计时 器 
$ systeminfol 
@) 音效 1 


$ FirstRun1 

= 微 数 据 库 1 

> 音频 播放 器 1 

+ BatteryState1 
$ NetworkState1 
= SystemSettings1 
$ AirPlaneState1 
Ø Activity 启 动 器 1 


开始 游戏 Sere 


图 20-12 抓 青蛙 游戏 主屏 幕 界面 布局 图 20-13 抓 青蛙 游戏 主屏 幕 的 组 件 列 表 1 


“草地 ”画布 中 包含 一 个 “青蛙 ”图 像 精 灵 ,“ 功 能 标签 水 平 布 局 ”中 包含 “开始 继续 游 
戏 ” 和 “查看 记录 ”两 个 标签 ， 如 图 20-14 所 示 。 


日 草地 
Mag 

日 国 功 能 标签 水 平 布局 
和 开始 继续 游戏 
和 A 查看 记录 


图 20-14 ” 抓 青蛙 游戏 主屏 幕 的 组 件 列 表 2 
各 组 件 的 属性 设置 见 表 20-1。 
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表 20-1 抓 青蛙 游戏 主屏 幕 的 组 件 属 性 


YE: 表 中 未 列 出 的 组 件 属性 ， 
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组 件 属性 
组 件 名 称 = 
属性 名 称 属性 值 
应 用 名 称 抓 青蛙 
背景 图 片 caodi.png 
Al bp qingwa.png 
是 否 显示 设置 荣 单 是 
Screen1l ae 
是 否 显示 更 新 版 本 菜单 是 
状态 栏 显示 否 
窗口 大 小 动 调整 
标题 展示 a 
字号 24.0 
宽度 充满 
数据 显示 文本 欢迎 进入 抓 青蛙 游戏 ! 
文本 对 齐 居中 
文本 颜色 青色 
背景 图 片 caodi.png 
草地 高 度 充满 
宽度 充满 
高 度 80 像素 
宽度 80 像素 
青蛙 图 片 qingwa.png 
X 坐标 114 
Y 坐标 124 
| 背景 颜色 透明 
功能 标签 水 平 布局 一 一 一 
宽度 充满 
字号 24.0 
、 宽度 50 比例 
开始 继续 游戏 —— 
文本 对 齐 居中 
文本 颜色 青色 
字号 24.0 
、 宽度 50 比例 
查看 记录 
文本 对 齐 居中 
文本 颜色 青色 
本 一 直 计时 7 
游戏 时 间 计 时 器 
由 用 计时 否 
en 循环 播放 是 
音频 播放 器 1 
源 文件 music.mid 


ey 


系统 提供 的 默认 值 。 


3) 功能 代码 。 
D 使 用 到 的 变量 和 初始 值 见 表 20-2。 


20-2 抓 青蛙 游戏 主屏 幕 的 全 局 变量 


变量 名 称 初 始 fi 
游戏 积分 0 
游戏 剩余 时 间 0 
游戏 积分 字符 串 
播放 背景 音乐 “on” 
D 屏幕 初始 化 时 运行 的 代码 如 图 20-15 所 示 。 


Ei -初始 化 
执行 ” 调用 EED .移动 到 指定 位 置 
x 坐标 


y 坐 标 


AA AE 
OE EET aed global EAE REA 
| 
U 词 用 CRE 
= 


图 20-15 ” 抓 青蛙 游戏 主屏 幕 初始 化 时 运行 的 代码 


调用 “青蛙 ”移动 到 指定 位 置 函数 移动 “青蛙 ”图 像 精 灵 到 “草地 ”画布 中 间 。 
“初始 化 数据 ”过 程 的 具体 代码 如 图 20-16 所 示 。 


2) 定义 过 程 OIE 
执行 语句 (0) MR FirstRun1 = -IsFirstRun => | | 
N 调用 GSS .保存 数值 
名 称 
标签 
存储 值 | 
是 否 加 密 
AA ETS Ree 
名 称 
标签 
存储 值 
是 否 加 密 


RECEDERTL SA AEE RIAI 
名 称 
标签 


无 标签 时 返回 值 
设置 GS . 应 用 说 明 > > | C) AAR ||" ELED" 
Li: Systeminfot = .GetAppVersion 


文本 

调用 ETLER . 富 文本 中 插入 图 片 
路 径 

RE 

高 度 

开始 字符 的 索引 值 

结束 字符 的 索引 值 

人 调用 CEST .设置 语文 本 为 标签 内 容 


图 20-16 “初始 化 数据 ”过 程 代码 
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第 一 次 运行 应 用 时 ， 设 置 播放 背景 音乐 ， 对 应 的 标签 “music” 的 值 为 “on”， 游 戏 的 积 
分 对 应 的 标签 “score” 的 值 为 “null”。 

设置 “Screen1” 屏 幕 的 “应 用 说 明 ” 内 容 为 “ 抓 青 蛙 + 应 用 版 本 号 + 梦幻 工作 室 2018”, 
也 就 是 单 击 “ 关 于 ”菜单 显示 的 内 容 。 

Android 系统 从 API 级 别 21 开始 才 支 持 Material Design 风格 设计 ， 调 用 “SystemInfo1” 
搬 件 ， 判 断 当 前 系统 的 API 级 别 是 否 大 于 等 于 21， 如 果 是 则 设置 “对 话 框 1” 的 显示 风格 为 
Material Design 风格 。 

为 了 丰富 显示 效果 ， 利 用 富 文本 功能 ， 把 “数据 显示 ”标签 的 文本 内 容 “ 欢 迎 进 入 抓 青 
星 游戏 !” 中 的 “青蛙 ”两 个 字 ， 用 “qingwa.png” 图 片 代 替 ， 如 图 20-17 所 示 。 


PAIR ATA SE hee 


图 20-17 ”欢迎 信息 


加 “开始 继续 游戏 ”标签 的 功能 代码 如 图 20-18 所 示 。 


执行 (x) 


rr TERRAN 
采 FHF 


否则 ” 调用 GHAD .显示 警告 信息 
通知 


一 


图 20-18 “开始 继续 游戏 ”标签 的 功能 代码 


如 果 标签 的 文本 内 容 为 “开始 游戏 "说明 用 户 正在 玩 第 一 局 ， 文 本 内 容 改 为 “再 来 
局 ”。 

设置 全 局 变量 “游戏 剩余 时 间 ” 的 值 为 30， 也 就 是 每 局 的 时 间 为 30s. 

D “游戏 时 间 计 时 器 ”的 功能 代码 如 图 20-19 所 示 。 


—, 
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设置 Behe . 文本 为 


调用 CED .移动 到 指定 位 置 


随机 整数 从 O 到 
随机 整数 从 O 到 


调用 Gre . 富 文本 中 插入 图 片 
路 径 

RE 

高 度 

开始 字符 的 索引 值 

结束 字符 的 索引 值 


图 20-19 “游戏 时 间 计 时 器 ”的 功能 代码 


计时 器 的 间隔 时 间 为 系统 默认 值 :1s。 
如 果 “ 游 戏 积分 ”的 值 大 于 等 于 20， 则 利用 富 文本 功能 ， 在 “数据 显示 ”标签 的 文本 
内 容 最 后 显示 一 个 “dianzan.png” 图 片 ， 如 图 20-20 所 示 。 


时 限 = Ooh. = #83) 25 f 


图 20-20 积分 提示 


“保存 积分 ”过 程 的 代码 如 图 20-21 所 示 。 

保存 积分 的 时 候 ， 首 先 从 “ 微 数据 库 1” 里 读 取 数 值 ， 并 赋值 给 全 局 变量 “游戏 积分 字 
RER”: 

如 果 值 为 “null”， 则 还 没有 保存 过 积分 ， 直 接 保存 全 局 变量 “游戏 积分 ”的 值 到 数据 
库 里 ; 

如 果 值 不 为 “null”， 则 意味 之 前 已 经 保存 过 积分 ， 把 “游戏 积分 字符 串 ” 的 内 容 后 面 加 
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上 过 号 ， 再 和 这 次 的 积分 合并 成 一 个 字符 串 保存 在 数据 库 里 ， 如 图 20-22 所 示 。 


获取 数值 
名 称 | 
标签 | 
无 标签 时 返回 值 | 


图 20-21 “保存 积分 ”过 程 的 代码 


record.xml x 


version= encoding= standalone= 


name= &quot;14,23,2,11,10,13&quot; 


图 20-22 ”保存 游戏 积分 文件 内 容 
@@“ 青 蛙 ” 图 像 精 灵 的 功能 代码 如 图 20-23 所 示 。 


4 GE .被 按压 
ttn yen 
eb) o ET global Haale) ~ > ~ o] 
出 由 调用 ES Bs 
zva | GD 
E Toba wR -EOT core it 


| 设置 ED . 到 3 为 | O 合 并 字符 串 


ST global HAD v) 


图 20-23 “青蛙 ”图 像 精灵 的 功能 代码 
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@ “查看 记录 ”标签 的 功能 代码 如 图 20-24 所 示 。 


当 Gre .被 单 击 
| OQ Vr eincine- . CHED @ Co 
wW (C) MR Sees | 调用 EIS .获取 数值 ED ‘ap’ 
名 称 | record ” 
标签 | “ 
无 标签 时 返回 值 | “ 


则 调用 GH .显示 警告 信息 
通知 
= 


否则 (打开 另 一 屏幕 屏幕 名 称 
— 
aN 调用 GSD .显示 警告 信息 


通知 


一 


图 20-24 “查看 记录 ”标签 的 功能 代码 
@ “设置 ”菜单 的 功能 代码 如 图 20-25 所 示 。 


当 - 单 击 设置 菜单 的 响应 函数 
执行 | 打开 另 一 屏幕 屏幕 名 称  “ 


图 20-25 ” 抓 青 蛙 游戏 “设置 ”菜单 的 功能 代码 


单 击 “ 设 置 ” 菜 单 ， 会 打开 “Screen2” 屏 幕 ， 就 是 设置 背景 音 的 屏幕 。 
“更 新 版 本 ”菜单 的 功能 代码 如 图 20-26 所 示 。 


当 单 击 更 新 版 本 菜单 的 响应 函数 
执行 | [cj OR 字符 串 比较 | 调用 CEASA GetAirPlaneState EER EID” 
U (C MR ”字符 串 比较 WA GetNetworkState (EER " ESSELEA" 
IAA .显示 选择 对 话 框 
We | * 未 连接 网 络 ， 请 检查 网 络 设置 加 


=). Wa d Activityeaias1 ~ M Action ~ Be) 
设置 CE . RGEURI 为 
罗江 Activity 后 双关 1 > -启动 活动 对 象 


图 20-26 ” 抓 青 蛙 游 戏 “ 更 新 版 本 ” 染 单 的 功能 代码 


单 击 “ 更 新 版 本 ”菜单 时 ， 设 备 如 处 于 飞行 模式 状态 ， 或 未 连接 网 络 状态 ， 会 调用 “对 
话 框 1” 显 示 选 择 对 话 框 ， 用 户 单 击 提示 框 的 “确定 ”按钮 ， 则 会 调用 “SystemSettings1” 
组 件 ， 打 开 系统 设置 界面 。 代 码 如 图 20-27 所 示 。 
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WG (C AR eres RES ED 


则 \ 调 用 SystemSettings 


图 20-27 抓 青蛙 游戏 主屏 幕 选择 对 话 框 的 功能 代码 
© “Screen1” 屏 幕 状 态 变 更 时 的 处 理 代码 如 图 20-28 和 图 20-29 所 示 。 


当 -屏幕 进入 暂停 状态 


图 20-28 “ 抓 青蛙 游戏 主屏 幕 进入 和 暂停 状态 时 的 功能 代码 


( 当 在 “Screen1” 屏 幕 打 开 “Screen2” 屏 幕 或 “Screen3” 屏 幕 时 , “Screen1” 屏 幕 进入 
暂停 状态 ， 在 “Screen1” 屏 幕 按 Home 键 ， 切 换 App 到 后 台 时 , “Screen1” 屏 幕 也 会 进入 和 暂 
PARAS) 


= .屏幕 进入 运行 状态 
| 执行 (©) 如 果 
则 
a 


图 20-29 ” 抓 青蛙 游戏 主屏 幕 进 入 运行 状态 时 的 功能 代码 


( 当 从 “Screen2” 屏 幕 或 “Screen3” 屏 幕 返 回 “Screen1” 屏 幕 时 , “Screen1” 屏 幕 进入 
运行 状态 ; 切换 App 从 后 台 切 换 到 前 台 时 ,“Screen1” 屏 幕 也 会 进入 运行 状态 。) 
电量 监测 的 处 理 代码 如 图 20-30 所 示 。 


EBatteryStatel ~ .BatteryStateLow 
执行 ”调用 GCHAR .显示 警告 信息 


n 


图 20-30 ”电量 监测 的 处 理 代 码 
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《因为 此 应 用 比较 耗 电 ， 在 “Screen1” 屏 幕 会 调用 “BatteryState1” 组 件 监 测 系统 的 电量 
状况 。) 

3. 设置 背景 音 的 屏幕 界面 及 功能 实现 

1) 界面 布局 如 图 20-31 PAN. 

2) 界面 使 用 的 组 件 列表 ， 如 图 20-32 所 示 。 


开启 背景 音乐 
关闭 背景 音乐 
组 件 列 表 
日 Screen2 
三 列表 显示 框 1 
微 数据 库 1 
À 对 话 框 1 
Ps anm Bsysteminft 
图 20-31 抓 青蛙 游戏 设置 屏幕 界面 布局 图 20-32 ” 抓 青蛙 游戏 设置 屏幕 的 组 件 列 表 
组 件 的 属性 设置 见 表 20-3。 
表 20-3 抓 青蛙 游戏 设置 屏幕 的 组 件 属性 
组 件 属性 
组 件 名 称 
Screen2 标题 设置 
背景 颜色 透明 
列表 显示 框 1 元 素 字 趾 He 
文本 颜色 黑色 


TE: 表 中 未 列 出 的 组 件 属 性 ， 使 用 系统 提供 的 默认 值 。 


3) 功能 代码 。 


Q@ 屏幕 初始 化 时 运行 的 代码 如 图 20-33 所 示 。 


Tsen 过 从 
执行 i aR 两 CEAD cose" ES E 


图 20-33” 抓 青蛙 游戏 设置 屏幕 初始 化 时 运行 的 代码 
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“列表 显示 框 1” 的 功能 代码 如 图 20-34 所 示 。 
当 .选择 完成 


执行 ”调用 CHED .显示 选择 对 话 杠 
消息 | “ 4 


> 
图 20-34 ”设置 屏幕 列表 显示 框 的 功能 代码 
© “对话 框 1” 的 功能 代码 如 图 20-35 所 示 。 


上 有 对话 框 1 = 区 
选择 值 
MT (cE eee Eee GE - Ea" 


N (CART Gin ee oo Oo 


则 RGAE 


ON AA GUE 保存 数值 
名 称 
标签 


图 20-35” 抓 青蛙 游戏 设置 屏幕 选择 对 话 框 的 功能 代码 


4. 查看 积分 记录 的 屏幕 界面 及 功能 实现 
1) 界面 布局 如 图 20-36 所 示 。 
2) 界面 使 用 的 组 件 列表 ， 如 图 20-37 所 示 。 


积分 排行 榜 


组 件 列表 

日 “| screen3 
Sean! 
三 微 数据 库 1 
$ azlListl 
HEE! 


+ SystemInfo1 


图 20-36 抓 青蛙 游戏 查看 积分 屏幕 界面 布局 图 20-37 抓 青蛙 游戏 查看 积分 屏幕 的 组 件 列表 
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组 件 的 属性 设置 见 表 20-4。 
表 20-4 抓 青蛙 游戏 查看 积分 屏幕 的 组 件 属 性 


组 件 属性 
组 件 名 称 
属性 名 称 属性 值 
Screen3 标题 积分 排行 榜 
EIS 背景 颜色 透明 
列表 显示 框 1 
文本 颜色 黑色 


注 : 表 中 未 列 出 的 组 件 属 性 ， 使 用 系统 提供 的 默认 值 。 


3) 功能 代码 。 
使 用 到 的 全 局 变量 和 初始 值 见 表 20-5. 


表 20-5 抓 青蛙 游戏 查看 积分 屏幕 的 全 局 变量 


变量 名 称 初始 值 
游戏 积分 字符 串 sie 
游戏 积分 列表 空 列表 


屏幕 初始 化 时 运行 的 代码 如 图 20-38 所 示 。 


标签 
无 标签 时 返回 什 


Pe] 20-38 ” 抓 青蛙 游戏 查看 积分 屏幕 的 初始 化 代码 


20.2 ”画图 应 用 


20.2.1 ”应 用 简介 


此 应 用 提供 了 以 下 功能 : 
1) 绘制 点 、 直 线 、 曲 线 、 三 角形 、 和 窍 形 、 圆 角 和 矩形 、 圆 和 椭圆 等 形状 ， 也 可 绘制 文本 。 
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2) 可 设置 画笔 的 颜色 、 线 条 的 宽度 和 文字 大 小 。 

3) 可 以 新 建 和 保存 图 片 文 件 ， 也 可 以 打开 设备 上 的 图 片 文件 进行 编辑 ， 还 可 以 把 区 
文件 上 传 到 云端 服务 器 和 从 云端 服务 器 下 载 图 片 。 

4) 可 设置 是 否 填 充 绘制 形状 包含 的 封闭 区 域 和 从 云端 下 载 图 片 需要 的 密码 。 
20.2.2 ”应 用 使 用 的 素材 


使 用 的 素材 如 图 20-39 所 示 。 


DS 
SF 


> 


素材 


draw.png 


图 20-39 画图 应 用 使 用 的 素材 


桌面 显示 的 Icon 图 片 。 


draw.pn 


20.2.3 ”应 用 使 用 的 插件 
使 用 的 插件 如 图 20-40 所 示 。 


ZIN D 


Extension 


Import extension 


$] Encryption 

$] AirPlaneState 
$] NetworkState 
$% FirstRun 


$] SystemSettings 


图 20-40 画图 应 用 使 用 的 插件 


加 密 功能 插件 ; 
获取 和 监测 设备 飞行 模式 状态 插件 ; 
FirstRun 判断 应 用 是 否 第 一 次 运行 插件 ; 
NetworkState 获取 和 监测 设备 网 络 状态 插件 ; 
SystemSettings 系统 设置 插件 。 


20.2.4 ”应 用 实现 


1. 屏幕 界面 
此 应 用 有 两 个 屏幕 : 主屏 幕 CScreenl) 和 设置 屏幕 (Screen2)。 
图 20-41 为 默认 的 主屏 幕 界面 ， 图 20-42 是 把 绘制 的 内 容 保存 成 图 片 后 的 主屏 幕 界 男 
(在 屏幕 的 最 上 方 显示 保存 文件 的 全 路 径 )。 

主屏 幕 底 部 水 平 显示 的 组 件 比 较 多 ， 如 果 设 备 的 屏幕 比较 小 ， 不 一 定 能 显示 完整 ， 所 以 
使 用 水 平 滚动 条 布局 ， 用 户 可 以 左右 滑动 手指 ， 滚 动 显 示 内 容 。 
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Encryption 
AirPlaneState 


/storage/emulated/0/demo.png 


Oh oO 


A 


Z 
文件 处 理 。 选择 形状 。 画笔 颜色 BR ”文本 大 小 RR 文件 处 理 ”选择 形状 BERR AR MAA RE 
图 20-41 画图 应 用 主屏 幕 界 面 1 图 20-42 ”画图 应 用 主屏 幕 界面 2 
图 20-42 主屏 幕 底部 最 右边 组 件 的 文本 没有 显示 完整 ， 可 以 向 左 滑 动 ， 以 便 完 整 显 示 ， 
如 图 20-43 所 示 。 


文件 处 理 ”选择 形状 。 画笔 颜色 AE ”文本 大 小 


橡皮 擦 
图 20-43 ”画图 应 用 主屏 幕 界面 底部 
主屏 幕 有 “退出 ”“ 关 于 ”“ 设 置 ” 和 “更 新 版 本 ”四 个 功能 菜单 ， 如 图 20-44 所 示 。 
图 20-45 是 单 击 “退出 ”菜单 显示 的 界面 ， 图 20-46 是 单 
未 命名 


击 “ 关 于 ”菜单 显示 的 界面 。 


画图 应 用 主 


主屏 幕 功能 沫 让 


Jg 


图 20-45 


单 击 “ 退 出 ”菜单 显示 的 界 
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单 击 “ 设 置 ”菜单 ， 会 打开 设置 屏幕 ， 单 击 “ 更 新 版 本 ” 沫 单 ， 会 打开 一 个 网 页 。 设 置 
屏幕 有 “退出 ”和 “关于 ”两 个 功能 菜单 ， 如 网 20-47 所 示 。 


} 


填充 区 域 © 
不 填充 区 域 © 
设置 密码 
请 输入 8 位 数字 或 字母 密码 C] 显示 密码 
1 关于 清空 保存 
画图 v1.0 
梦幻 工作 室 2018 
| ow | 
退出 关于 


图 20-47 画图 应 用 设置 屏幕 界面 


图 20-46 FRG RT” SAA A FEI 


2. 主屏 幕 界面 及 功能 实现 
1) 界面 布局 如 图 20-48 所 示 。 
2) 界面 使 用 的 组 件 列表 ， 如 图 20-49 所 示 。 


组 件 列表 
8 Screen] 
标签 1 
ABI 
Se EET 
水 平 滚动 条 布局 1 
A 对 话 框 1 

文件 管理 器 1 
国 web 客 户 站 
网 络 微 数据 库 1 


$ FirstRun1 
微 数 据 库 1 
$ NetworkState1 


+ SystemSettings1 


$ AirPlaneState1 
| | >” Activity 启 动 器 1 
= eS [ ® Encryption! 
图 20-48 画图 应 用 主屏 幕 界面 布局 图 20-49 画图 应 用 主屏 幕 的 组 件 列表 1 
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“水 平 滚动 条 布局 1” 中 包含 的 组 件 如 图 20-50 所 示 。 


= 水 平 滚动 条 布局 1 
文件 处 理 
选择 形状 
画笔 颜色 
线 宽 
文本 大 小 
BRB 


图 20-50 画图 应 用 主屏 幕 的 组 件 列表 2 


组 件 的 属性 设置 见 表 20-6。 
表 20-6 画图 应 用 主屏 幕 的 组 件 属性 
组 件 名 称 mee 
属性 名 称 属性 值 
应 用 说 明 画图 v1.0\n 梦幻 工作 室 2018 
应 用 名 称 画图 
Al bx draw.png 
ree 是 否 显示 设置 荣 单 是 
是 否 显示 更 新 版 本 菜单 是 
状态 栏 显示 T 
窗口 大 小 动 调整 
标题 展示 a 
标签 1 高 度 4 比例 
宽度 充满 
oon 高 度 90 比例 
宽度 充满 
图 像 选择 框 1 可 见 性 a 
垂直 对 齐 居中 
水 平 滚动 条 布局 1 一 
ry BE 6 比例 
宽度 充满 
背景 颜色 透明 
TERE A 新 建 ,打开 ,保存 ,另存 为 ,上 传 ,下 载 
项 背景 色 色 
文件 处 理 项 文本 色 黑色 
形状 页 
文本 文件 处 理 
标题 文件 处 理 
选择 形状 背景 颜色 透明 
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组 件 属 性 
组 件 名 称 
属性 名 称 BHEE 
a p 点 ， 直线 ,曲线 ,三 形 ,矩形 ， 
bine Bl $6 ELT PAL AMAL, SCS 
项 背景 色 色 
项 文本 名 PA ft; 
选择 形状 RE = 
形状 页 
文本 选择 形状 
标题 选择 形状 
背景 颜色 透明 
黑色 , 蓝 色 ,青色 , 深 灰 ,灰色 , 浅 灰 ， 
元 素 字 串 绿色 , 品 红 , 橙 色 , 粉 色 , 红 色 , 白 色 ， 
黄色 
HERE 色 
画笔 颜色 
项 文本 色 黑色 
形状 页 
文本 画笔 颜色 
标题 画笔 颜色 
背景 颜色 透 日 
线 宽 形状 ia 
文本 线 宽 
背景 颜色 N 
文本 大 小 形状 页 
文本 文本 大 小 
背景 颜色 透 日 
橡皮 擦 形状 i 
All ebb Pet http://tinywebdb.gzjkw.net/db.php? 
网 络 微 数据 库 1 民 务 地 址 User=Xjbclz&pw=123abc456&v=1 
YE: 表 中 未 列 出 的 组 件 属性 ， 使 用 系统 提供 的 默认 值 。 
3) 功能 代码 。 
Q 使 用 到 的 全 局 变量 和 初始 值 见 表 20-7。 


表 20-7 画图 应 用 主屏 幕 的 全 局 变量 


变量 名 称 初 始 值 
文件 全 路 径 未 命名 
文件 名 称 未 命名 
文件 处 理 s 
文件 内 容 ‘i 
设置 属性 了 
密码 
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变量 名 称 初 始 值 
起 点 x 坐标 0 
起 点 y 坐标 0 
HHF 0 
度 0 
线 宽 0 
画布 颜色 0 
填充 假 
选中 橡皮 探 假 

画笔 颜色 列表 〈 见 图 20-51) 


“画笔 颜色 列表 ”的 初始 值 如 图 20-51 所 示 。 


初始 化 全 局 变量 [EEC E 滞 为 AO) 创建 列表 


图 20-51 “画布 颜色 列表 ”的 初始 值 
© 屏幕 初始 化 时 运行 的 代码 如 图 20-52 所 示 。 


E Screent ~ Fi id 
执行 REL 


国光 让 Systeminfo1 二 区 < 


图 20-52 ”画图 应 用 主屏 幕 初始 化 时 运行 的 代码 
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在 没有 保存 绘制 画布 上 的 内 容 时 ， 屏 幕 顶部 的 标签 显示 的 文件 名 为 “未 命名 ” 提示 用 
户 还 没有 执行 过 保存 操作 。 

第 一 次 运行 应 用 时 ， 设 置 不 填充 绘制 形状 包含 的 封闭 区 域 ， 对 应 的 标签 “fill” 的 值 
为 假 。 

Android 系统 从 API 级 别 21 开始 才 文 持 Material Design 风格 设计 ， 调 用 “SystemInfo1?” 
插件 ， 判 断 当 前 系统 的 API 级 别 是 否 大 于 等 于 21， 如 果 是 则 设置 “对 话 框 1” 的 显示 风格 为 
Material Design 风格 。 

© 屏幕 进入 运行 状态 时 的 代码 如 图 20-53 所 示 。 


.屏幕 进入 运行 状态 
i ES Tolobal 3s ~ 为 调用 acer 


无 标签 时 返回 值 0 GERD 


图 20-53 画图 应 用 主屏 幕 进入 运行 状态 时 的 代码 


(屏幕 初始 化 完成 后 ， 就 进入 运行 状态 ， 从 设置 屏幕 返回 到 主屏 幕 时 ， 也 会 进入 运行 
状态 。) 
O 单 击 “文件 处 理 ” 列 表 显 示 框 ， 显 示 如 图 20-54 所 示 界 面 。 


新 建 


打开 


保存 


另存 为 


上 传 


下 载 


py 


图 20-54 文件 处 理 功能 列表 界面 
对 应 的 功能 代码 如 图 20-55 所 示 。 
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当 xe .选择 完成 
:global 文件 外 理 - [文件 处 至- ean | 
global 文件 处 理 > | 
OR CAD. EED G3 

NI i CAD . EEEE 


调用 EGLE ARARSA) EB 


调用 CHAD .显示 文本 对 话 框 


消息 
ha 


aU 调用 GHAD .显示 警告 信息 
通知 | E 


ID .6239% | 调用 CAD . 另 存 为 … 
文件 名 ROTE 
为 ee! ~ xa 


T ES Tolobal RERE E) 
调用 GHD .显示 文本 对 话 框 


消息 E 


否则 调用 HE .显示 警告 信息 
通知 
ha 
= 


日 SEE ees Me T global 文件 处 理 -| 
则 [2 如果 “字符 中 比较 | 调用 [ETE GetAirPlaneState | 人 


Wo) OR! 调用 .GetNetworkstate ESS 
则 调用 CHAD .显示 进程 对 话 框 
消息 
标题 
设置 .为 
调用 CESSES .执行 PUT 文 件 请 求 
路 径 


一 


否则 ” 调用 GHAD .显示 选择 对 话 框 
消息 
œ 
二 


否则 调用 GS .显示 选择 对 话 框 
消息 


,global 文件 处 至 = | 
global 设置 展 性 ~ EINA Pees be 
可 上 .显示 文本 对 话 框 
He * Ges" 


项 


20-55 “文件 处 理 ” 列 表 显 示 框 的 功能 代码 
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选中 “打开 ”选项 时 ， 调 


“图 像 选择 框 1”， 可 以 选择 设备 上 的 图 片 ， 选 择 完成 后 ， 


把 选中 的 图 片 设置 为 “画布 1” 的 背景 图 片 ， 代 码 如 图 20-56 所 示 。 


选中 “保存 ”选项 时 ， 如 果 
存 成 文件 ， 需 要 有 存储 空 
1MB 的 时 候 ， 才 能 保存 文件 
保存 成 文件 ， 


png 格式 。 


选中 “上 传 ”选项 时 ， 把 图 片 」 
upload.php。 
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图 20-57 选择 图 片 的 界 


图 20-56 图 像 选择 框 的 功能 代码 


未 命名 


fl 图 20-58 ”选择 完 图 片 后 的 主屏 幕 界面 


间 保 存 新 文件 ， 在 保存 


不 需要 用 户 再 输入 文件 名 称 。 
选中 “另存 为 ”选项 时 ， 也 需要 有 存储 空间 保存 新 文件 ， 在 保存 前 获取 剩余 存储 空间 大 
小 ， 只 有 不 小 于 IMB 的 时 候 ， 才 能 保存 文件 ， 且 需要 用 户 输 入 文件 名 称 。 
在 输入 文件 名 称 时 ， 只 需 输入 主 文件 名 ， 不 需 输入 文件 后 级 ， 应 用 默认 把 图 片 保存 成 


上 传 完 图 片 后 ， 把 


图 20-57 为 选择 图 片 的 界面 ， 图 20-58 为 选择 完 图 片 后 的 主屏 幕 界面 。 


文件 处 理 ”选择 形状 。 画笔 颜色 AE ”文本 大 小 ”橡皮 


“标签 1” 的 文本 为 “未 命名 ”， 说 明 画 布 上 的 内 容 还 未 保 
前 获取 剩余 存储 空间 大 小 ， 只 有 不 小 于 
， 了 且 需 要 用 户 输入 文件 名 称 ， 如 果 不 为 “未 命名 ”， 则 说 明 已 经 


上传 到 云端 服务 器 ， 网 址 为 http://appimage.gzjkw.net/ 
图 片 的 网 址 保存 在 网 络 数 据 库 中 ， 


以 便 后 续 下 载 用 。 代 码 如 


20-59 所 示 。 


图 20-59 保存 图 片 网 址 的 代码 


(把 图 片 和 图 片 网 址 保存 在 云端 服务 器 ， 这 样 如 果 用 户 丢 失 了 设备 ， 或 换 了 设备 ， 就 可 
以 从 云端 服务 器 获取 到 图 片 ， 而 不 会 丢失 图 片 。) 

选中 “下 载 ” 选 项 时 ， 需 要 先 输入 正确 的 密码 ， 才 能 从 到 云端 服务 器 下 载 图 片 。 下 载 完 
后 ， 自 动 把 图 片 设置 为 画布 的 背景 图 片 。 

“网 络 微 数据 库 1” 的 功能 代码 如 图 20-60 一 图 20-62 所 示 。 


| 调用 CHED .关闭 进程 对 话 框 
调用 CHAD .显示 警告 信息 


= 


图 20-60 ”主屏 幕 网 络 微 数据 库 的 功能 代码 1 
注 : 把 图 片 的 网 址 保存 到 云端 服务 器 后 ， 调 用 的 代码 。 


执行 和 [之 如果 字符 申 比较 pl RY Ge 
,Ne hkk E E 
则 mE IE 


CMR pkt MEES 
则 | 后 | MR | 


| 调用 GHA .关闭 进程 对 话 杠 
调用 GAIN .显示 警告 信息 
通知 


图 20-61 主屏 幕 网 络 微 数 据 库 的 功能 代码 2 
注 ， 从 云端 服务 器 获取 密码 和 图 片 网 址 的 代码 。 
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© 单 击 “选择 形状 ”列表 显示 框 ， 显 示 如 图 20-63 所 示 界 面 。 


直线 
曲线 
三 角形 
矩形 
贺 角 矩形 
椭圆 

执行 ” 调用 CGHED .关闭 进程 对 话 杠 文本 

调用 CGHED 2necses 
= 
图 20-62 ”主屏 幕 网 络 微 数据 库 的 功能 代码 3 图 20-63 ”形状 列表 界 再 


对 应 的 功能 代码 如 图 20-64 所 示 。 


ib i RAXA Ie 


图 20-64 “选择 形状 ”列表 显示 框 的 功能 代码 


O 单 击 “画笔 颜色 ”列表 显示 框 ， 显 示 如 图 20-65 所 示 界 面 。 
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图 20-65 ”颜色 列表 界面 
对 应 的 功能 代码 如 图 20-66 所 示 。 


当 EHD .被 单 击 
执行 设置 global RERE -EMEEK 
调用 GSR .显示 文本 对 话 杠 


Aa, 
图 20-67 “ 线 宽 ” 按 钮 的 功能 代码 
@@“ 文 本 大 小 ”按钮 的 功能 代码 如 图 20-68 所 示 。 


(i (Es Toora RE RE - PE Ca 
调用 Gi .显示 文本 对 话 杠 
He “ESEI 


— 
图 20-68 “文本 大 小 ”按钮 的 功能 代码 
“橡皮 擦 ”按钮 的 功能 代码 如 图 20-69 所 示 。 
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图 20-69 “橡皮 擦 ” 按 钮 的 功能 代码 


使 用 橡皮 擦 功能 时 ， 会 设置 画笔 颜色 为 白色 ， 线 宽 为 8， 需 要 先 保 存 当前 的 画笔 
线 宽 值 ， 以 备 后 续 绘 制图 形 使 用 。 
O “对 话 框 1” 文 本 对 话 框 的 功能 代码 如 图 20-70 所 示 。 


oJMR Hpt OMEO E 
U XE CAD. CD 为 | Ree 


OE ie ROE 
CES Toba mae EME oE ~) 


JAR Tien Me global 设置 必 性 = | 
M 设置 io . EZD 为 REND 


[GR 字 特 中 比较 MOE 
TE ooa zsa -| 


AR Pept AME 
IE Tean (| Ro 
mg TI > | 调用 CD -另存 为 -… 
文件 名 l Toba ea 


MR 字 竺 申 比较 CCE E 
WEST olobal #25 ~ AA Encryptiont ~ makeMD5Hash 
| srcStr | 取 
CJR 字符 趾 比 较 (| 调用 CASA GetAiPlaneState 


yw ae CD cotNeworsiate EER 
UN 调用 GHEAD ante 
消息 
标题 
AA 网 络 微 数据 .获取 数值 
< 标签 
否则 ” 调用 GSD .显示 选择 对 话 框 
消息 


— 
= 


AU AA GHAD .显示 选择 对 话 杠 
消息 “E 
~= 
m 


图 20-70 ”画图 应 用 主屏 幕 文本 对 话 框 的 功能 代码 
在 使 用 文本 对 话 框 的 时 候 ， 用 户 可 能 忘记 输入 ， 直 接 单 击 了 “确定 ”按钮 ， 
应 用 出 现 异 常 ， 为 了 避免 这 个 情况 发 生 ， 增 加 判断 只 有 当 响 应 内 容 不 是 “取消 ” 字 
字符 串 的 时 候 ， 才 会 执行 后 续 代码 。 
“画布 1” 的 功能 代码 如 图 20-71 一 图 20-73 所 示 。 
216 


站 颜色 和 


这 样 会 导致 


符 串 和 空 


4 ake 被 按压 
x 坐 标 ， y 坐 标 
执行 ”设置 为 | RED 
设置 为 RD 
22 GS 62595 O 合并 字符 串 


C=. resis | CE Eo “ea” 
则 | 调用 ee . 画 点 

x 坐标 

y 坐 标 


图 20-71 画布 被 按压 时 的 功能 代码 


SEW .手指 在 画布 上 移动 
一 一 | 一 一 


CEL + (Ree ED E 
u AR GAD BA 


图 20-72 ”手指 在 画布 上 移动 时 的 功能 代码 


用 户 用 手指 单 击 屏 幕 时 ， 在 顶部 标签 上 显示 当前 点 的 x 和 yy 坐标 ， 作 为 起 点 坐标 ， 手 指 
在 屏幕 上 移动 时 ， 把 当前 点 的 坐标 作为 终点 坐标 ， 显 示 在 顶部 标签 。 手 指 离开 屏幕 ， 意 味 用 
户 不 再 绘制 ， 此 时 在 顶部 标签 上 显示 文件 名 称 。 

@3“ 擦 除 ” 过 程 的 功能 代码 如 图 20-74 所 示 。 
Elan .被 松 开 

Um ve 

执行 C 如 果 |! 


| 调用 (EE ma 


xt | 
yl | 
x2 

y2 | 


图 20-73 ”画布 被 松 开 时 的 功能 代码 图 20-74 “ 擦 除 ” 过 程 的 功能 代码 


擦 除 功能 就 是 利用 在 屏幕 上 绘制 白色 的 直线 实现 的 。 
“绘制 ”过 程 的 功能 代码 如 图 20-75 所 示 。 
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0) 定义 过 程 ED 
执行 语句 (JAR 字符 申 比较 Re ED 
WN 调用 GAD oa 


x1 


ka 
MEL epte AA E 


N 调用 Gi .路 径 起 点 
bet Mn i global 起 点 x 坐标 ~ | 


调用 LD .三 次 贝 塞 尔 曲线 


调用 GID :绘制 路 径 
填充 
\、 调 用 GIR .清空 路 径 


© sree CEE ERS * 12" 
N WF CID AREA 
xet 
vei 
调用 Lid .路 径 节点 


ba 
调用 GID Smee 
调用 GAD 绘制 路 径 
global 其 元 > | 
\、 调 用 (DE .清空 路 径 


JMET serte A =~ en eve 
NW AA [DE Ber 


ki 
OE Ge AES E 
则 调用 GD 盏 四 角 答 形 
left 
top 
right 
bottom 
OBE 
MARAE 
填充 


q 
JAR 字符 下 比较 NE 
Pe EO) 
作用 范围 i + 为 Ft 
EE i Ra) | 
AR CID EA 
圆心 x 坐 标 
圆心 y 坐 标 
+a 
填充 


& 
kz 


oja Feste Mee | clobal 开交- E 
WN AA CAD aan 


OWE es meV global fan ~ Il =~] 
u AELB 
re) 
v&i | ROE 
调用 CID . 沿 角度 绘制 文本 
文本 
x 坐标 
ye 
角度 


图 20-75 “绘制 ”过 程 的 功能 代码 
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曲 “ 角 度 ” 过 程 的 功能 代码 如 图 20-76 所 示 。 


图 20-76 “角度 ”过 程 的 功能 代码 


下 ， 所 以 角度 值 的 正 负 值 刚 好 相反 。 
“设置 ”菜单 的 功能 代码 如 图 20-77 所 示 。 


z 单 击 设置 菜单 的 响应 函数 
执行 打开 另 一 屏幕 屏幕 名 称 “ 


图 20-77 ”画图 应 用 “设置 ”菜单 的 功能 代码 
单 击 “ 设 置 ” 菜单 ， 会 打开 “Screen2” 屏 幕 ， 就 是 设置 背景 音 的 屏幕 。 
“更 新 版 本 ”菜单 的 功能 代码 如 图 20-78 所 示 。 


当 单 击 更 新 版 本 菜单 的 响应 函数 
执行 [之 如 果 字符 趾 比 较 | 调用 CEEIESEIOIE3 GetAiPlaneState EED " ELD” | 
则 NetworkStatol GetNetworkState CEB « 
NU 调用 GSE .显示 选择 对 话 杠 
E 消息 | " EME, Mamas be 
=) i GUE ELE Acton ~ 为 
SE CODER . CHUD > 
Eyans 启动 活动 对 象 


否则 调用 GHAD .显示 选择 对 话 框 
消息 


图 20-78 画图 应 用 “更 新 版 本 ”菜单 的 功能 代码 
“对 话 框 1” 选 择 对 话 框 的 功能 代码 如 图 20-79 所 示 。 


角度 值 是 在 绘制 文本 时 用 的 ， 因 为 计算 角度 和 绘制 文本 时 的 y 轴 坐 标 一 个 向 上 ， 


一 个 向 


上 传 或 下 载 文件 ， 以 及 单 击 “ 更 新 版 本 ”菜单 时 ， 如 设备 处 于 飞行 模式 状态 ， 或 未 连接 
网 络 状态 ， 会 调用 “对 话 框 1” 显 示 选 择 对 话 框 ， 用 户 单 击 提示 框 的 “确定 ”按钮 ， 则 会 调 


| 


用 “SystemSettings1” 组 件 ， 打 开 系 统 设置 界面 。 


当 CHED .选择 完成 


AFE | 


EG ‘SystemSettings 


图 20-79 画图 应 用 主屏 幕 选 择 对 话 框 的 功能 代码 
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异常 处 理 的 功能 代码 如 图 20-80 所 示 。 


当 GT .出 现 错误 
函数 名 称 


执行 | 调用 CHIES .关闭 进程 对 话 框 


图 20-80 画图 应 用 主屏 幕 异常 处 理 的 功能 代码 


在 应 用 运行 的 时 候 ， 尤 其 在 上 传 和 下 载 文 件 的 过 程 中 ， 涉 及 网 络 数据 传输 ， 可 能 会 遇 到 
各 种 异常 ， 此 时 需要 关闭 进程 对 话 框 ， 和 否则 ， 即 使 应 用 不 能 正常 运行 了 ， 进 程 对 话 框 还 会 一 
直 显 示 。 
“出 现 错误 ”函数 自身 会 调用 对 话 框 组 件 函数 显示 出 错 信息 ， 开 发 人 员 不 需要 再 调用 函 
数 显示 出 错 信 息 。 函 数 源码 在 Screen 的 源码 文件 Formjava 中 ， 代 码 如 下 : 


@SimpleEvent( 


description = "Event raised when an error occurs. Only some errors will " + 


T 


"raise this condition. For those errors, the system will show a notification " + 
"by default. You can use this event handler to prescribe an error " + 
"behavior different than the default.") 
public void ErrorOccurred(Component component, String functionName, int errorNumber, 
String message) { 
String componentType = component.getClass().getName(); 
componentType = componentType.substring(componentType.lastIndexOf(".") + 1); 
Log.e(LOG_TAG "Form " + formName + " ErrorOccurred, errorNumber = " + errorNumber + 
", componentType =" + componentType + ", functionName = " + functionName + 
", messages = " + message); 
if ((!(EventDispatcher.dispatchEvent( 
this, "ErrorOccurred", component, functionName, errorNumber, message))) 
&& screenInitialized) { 
// If dispatchEvent returned false, then no user-supplied error handler was run. 
// If in addition, the screen initializer was run, then we assume that the 
// user did not provide an error handler. In this case, we run a default 
// error handler, namely, showing a notification to the end user of the app. 
// The app writer can override this by providing an error handler. 
new Notifier(this).ShowAlert("Error " + errorNumber + ": " + message); 


} 


3. 设置 屏幕 界面 及 功能 实现 
1) 界面 布局 如 图 20-81 所 示 。 
2) 界面 使 用 的 组 件 列表 ， 如 图 20-82 所 示 。 


À 
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Sgt a= 
日 Screen2 


标签 1 


填充 区 域 三 列表 显示 框 1 


标签 2 
水 平 布局 1 
密码 输入 框 1 


D 


EE 显示 密码 4S HEI 
水 平 布局 2 


oO 


清空 保存 


see 
iA 


Hit 


保存 
对 话 框 1 
微 数据 库 1 
型 Encryption1 
网 络 微 数据 库 1 
™ AirPlaneState1 


> NetworkStatel 
5j 全 — 型 SystemSettings1 


al 


图 20-81 画图 应 用 设置 屏幕 界面 布 


组 件 的 属性 设置 见 表 20-8。 


图 20-82 画图 应 用 设置 屏幕 的 组 件 列表 


表 20-8 画图 应 用 设置 屏幕 的 组 件 属性 


组 件 属 性 
组 件 名 称 = 
属性 名 称 属性 值 
应 用 说 明 画图 v1.0 \ 梦幻 工作 室 2018 
Screenl 
标题 设置 
标签 1 宽度 充满 
文本 填充 选项 
元 素 字 串 填充 区 域 ,不 填充 区 域 
列表 显示 框 1 一 一 
文本 颜色 黑色 
字号 16 
标签 2 宽度 充满 
文本 设置 密码 
垂直 对 齐 居中 
水 乎 布局 1 - 
宽度 充满 
宽度 60 比例 
密码 输入 框 1 提示 请 输入 8 位 数字 或 字母 密码 
文本 长 度 8 
复 选 框 1 宽度 40 比例 
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组 件 属 性 
组 件 名 称 
属性 名 称 属性 值 
复 选 框 1 文本 显示 密码 
水 平 布 局 2 宽度 充满 
宽度 50 比例 
清空 
文本 清空 
宽度 50 比例 
保存 
文本 保存 
pran http://tinywebdb.gzjkw.net/db.php? 
网 络 微 数据 库 1 服务 地 址 User=xjbclz&pw=123abc456&v=1 
注 : 表 中 未 列 出 的 组 件 属性 ， 使 用 系统 提供 的 默认 值 。 


3) 功能 代码 。 
O 使 用 到 的 全 局 变量 和 初始 值 见 表 20-9。 


表 20-9 画图 应 用 设置 屏幕 的 全 局 变量 


变量 名 称 初始 值 
密码 显示 ff 
旧 密 码 


“列表 显示 框 1” 的 功能 代码 如 图 20-83 所 示 。 


Cat RE 
oe MT 


el” AA CETHE 


二 


图 20-83 画图 应 用 设置 屏幕 列表 显示 框 的 功能 代码 
(@)“ 复 选 框 1” 的 功能 代码 如 图 20-84 所 示 。 


"(Sa a 


则 RE Ba (EÐ 
i TET 


EN 


图 20-84 复 选 框 的 功能 代码 
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全 “清空 ”按钮 的 功能 代码 如 图 20-85 所 示 。 


图 20-85 “清空 ”按钮 的 功能 代码 
@@“ 保 存 ” 按 钮 的 功能 代码 如 图 20-86 所 示 。 


2) MR) WA CEEE .GetNetworkstate (ERB -ESEEEB | 
调用 GED .显示 进程 对 话 杠 
消息 
标题 
调用 CL 获取 数值 
标签 
SN 调用 Gis .显示 选择 对 话 框 
消息 


否则 ”调用 GHAD .显示 选择 对 话 框 
设备 处 于 和 


否则 调用 GHAD .显示 警告 信息 
SANT 轩 


一 


图 20-86 “保存 ”按钮 的 功能 代码 


用 户 单 击 “ 保 存 ” 按 钮 时 ， 首 先 判 断 密码 长 度 是 否 满足 要 求 ， 只 有 长 度 满足 ， 才 执行 后 
续 代码 。 
© “网 络 微 数 据 库 1” 的 功能 代码 如 图 20-87 一 图 20-89 所 示 。 


| 调用 GSES .关闭 进程 对 话 框 


调用 GES -PRAHE 
消息 


a 
a 调用 GES 


用 .makeMD5Hash 


SrcStr 


图 20-87 设置 屏幕 网 络 微 数据 库 的 功能 代码 1 
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在 保存 密码 时 ， 首 先 从 网 络 微 数据 库 中 获取 密码 ， 如 果 获 得 的 密码 长 度 不 是 32 (在 保 
存 密码 时 ， 把 密码 用 MDS 加 密 ， 转 化 成 长 度 是 32 的 字符 串 )， 则 认为 是 首次 设置 密码 ， 直 
接 保存 密码 ， 否 则 显示 文本 对 话 框 ， 让 用 户 输入 旧 密码 ， 只 有 旧 密 码 输 入 正确 ， 才 能 保存 新 
密码 。 


执行 ”调用 GHAD .关闭 进程 对 话 框 
| 调用 GSD .显示 警告 信息 
通知 


调用 CHAD .显示 警告 信息 


图 20-89 设置 屏幕 网 络 微 数据 库 的 功能 代码 3 
D “对话 框 1” 的 功能 代码 如 图 20-90 和 图 20-91 所 示 。 


M CAR E makemDsHash  E3 o a 
srcStr (| 取 OFE 


调用 -makeMD5Hash 
SrcStr 


二 


图 20-90 画图 应 用 设置 屏幕 对 话 框 的 功能 代码 1 


在 使 用 文本 对 话 框 的 时 候 ， 用 户 可 能 忘记 输入 ， 直 接 单 击 了 “确定 ”按钮 ， 因 为 密码 长 
度 为 8， 这 样 密码 肯定 不 对 ， 就 不 需要 和 旧 密 码 进行 比较 了 ;所 以 增加 判断 ， 只 有 当 响 应 内 
容 不 是 “取消 ”字符 串 和 空 字符 串 的 时 候 ， 才 会 执行 后 续 代码 。 

®© 异常 处 理 的 功能 代码 如 图 20-92 所 示 。 

在 应 用 运行 的 时 候 ， 尤 其 在 保存 密码 的 过 程 中 ， 涉 及 网 络 数据 传输 ， 可 能 会 遇 到 各 种 异 
常 ， 此 时 需要 关闭 进程 对 话 框 ， 和 否则 ， 即 使 应 用 不 能 正常 运行 了 ， 进 程 对 话 框 还 会 一 直 


显示 。 
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| 当 Scroen2 ~ .出 现 错误 


1 TT a Rh Rs 基 忆 


则 ”调用 SystemSettings 
| 


执行 、 调 用 CHH .关闭 进程 对 话 框 


图 20-91 画图 应 用 设置 屏幕 对 话 框 的 功能 代码 2 ” 图 20-92 画图 应 用 设置 屏幕 异常 处 理 的 功能 代码 


20.3 ”定位 应 用 


20.3.1 ”应 用 简介 


此 应 用 可 设置 监测 对 象 所 处 在 的 地 理 围 栏 ， 并 实时 监测 对 象 的 位 置 是 否 处 在 地 理 围栏 之 
内 ， 如 果 不 在 地 理 围栏 之 内 ， 会 自动 拨打 设置 的 通知 手机 号 码 和 向 此 手机 号 发 送 短信 报警 ， 
可 用 于 监测 人 员 位置 、 宠 物 位 置 和 物体 的 位 置 等 。 

此 应 用 使 用 了 高 德 开 放 平台 提供 的 Web 服务 API 坐标 转换 、 地 理 / 逆 地 理 编 码 、 静 态 地 
图 和 地 理 围 栏 服务 等 HTTP 接 


此 应 用 的 主要 运行 流程 如 图 20-93 所 示 。 


启动 


设置 通知 号 码 


图 20-93 ”流程 图 


流程 说 明 : 
1) 此 应 用 一 启动 ， 就 调用 位 置 传感器 开始 定位 ， 同 时 从 微 数据 库 里 获取 通知 手机 号 码 


T 
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框 ， 请 用 户 设置 通知 手机 号 码 。 


的 数值 ， 如 果 值 不 为 空 ， 则 不 做 任何 处 理 ， 此 子 流程 终止 ， 如 果 值 为 空 ， 


则 会 显示 文本 对 话 


服务 器 API 坐标 转换 HTTP #20, JE GPS 4 


2) 使 用 位 置 传感器 获取 到 的 经 纬度 坐标 是 GPS 坐标 系 坐 标 ， 需 要 调 


3) 获得 高 德 坐 标 系 坐 标 后 ， 调 


高 德 提供 的 Web 服务 器 API 逆 地 到 


通过 坐标 获取 实际 的 地 址 信息 ， 并 设置 成 标签 文本 ， 展 示 给 有 
服务 器 API 项 态 地 图 HTTP 接口 ， 将 高 德 地 图 以 图 片 形 式 典 入 网 页 中 ， 并 在 地 
署 处 添加 标签 ， 显 示 在 Web 浏览 框 中 。 


Hs 以 及 调 


~ 


用 高 德 提供 的 Web 
标 系 坐标 转换 成 高 德 坐 标 系 坐标 。 

编码 HTTP 接口 
高 德 提 供 的 Web 
图 上 的 当前 位 


昌 户 就 可 设置 地 理 


4) 获取 到 实际 的 地 址 信息 ， 并 设置 成 标签 文本 ， 展 示 给 用 户 后 ， 月 


栏 半径 。 设 置 完成 后 ， 调 用 高 德 提供 的 Web 服务 器 API 创建 地 理 


围栏 HTTP 接 


F] 


个 圆 形 围栏 : 中 心 点 的 坐标 是 当前 位 置 坐标 ， 半 径 是 用 户 设置 的 地 理 围栏 半径 。 
5) 创建 完 地 理 围 栏 后 ， 应 用 每 隔 Imin 调用 


次 高 德 提供 的 Web 服务 器 API 围栏 设备 


， 创 建 一 


监控 HTTP 接口 ， 查 询 当 前 位 置 是 否 在 地 理 围栏 内 : 如 果 在 地 理 围 栏 内 ， 则 设置 标签 文本 为 
“当前 位 置 在 地 理 围栏 内 ” 并 展示 给 用 户 ; 否则 设置 标签 文本 为 “当前 位 置 在 地 理 围栏 


外 ” 展示 给 用 户 ， 同 时 自动 拨打 设置 的 通知 手机 号 码 和 向 此 手机 号 发 送 短 信 报 警 。 


20.3.2 ”应 用 使 用 的 素材 
使 用 的 素材 如 图 20-94 所 示 。 


素材 


dingwei.png 


图 20-94 ”定位 使 用 使 用 的 素材 


dingwei.png 应 用 在 系统 桌面 显示 的 Icon 图 片 。 


20.3.3 ”应 用 使 用 的 插件 
使 用 的 插件 如 图 20-95 所 示 。 


DS 
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Import extension 


AirPlaneState 
FirstRun 


JSONCreate 


| LocationState 
| MobilePhoneNumber 
| NetworkState 


| Systeminfo 


SystemSettings 


H 


20-95 定位 使 用 使 用 的 插件 


AirPlaneState 获取 和 监测 设备 飞行 模式 状态 插件 ; 
FirstRun 判断 应 用 是 否 第 一 次 运行 插件 ; 
JSONCreate 一 一 创建 JSON 字符 串 插件 ; 
LocationState 获取 定位 功能 状态 插件 ; 
MobilePhoneNumber 手机 号 码 校 验 插件 ; 
NetworkState 获取 和 监测 设备 网 络 状态 插件 ; 
SystemInfo 获取 设备 和 系统 信息 插件 ; 
SystemSettings 系统 设置 插件 。 


20.3.4 ”应 用 实现 


1. 屏幕 界面 

此 应 用 有 一 个 屏幕 : 主屏 幕 〈Screenl )。 

第 一 次 启动 应 用 时 ， 会 现在 主屏 幕 界 面 显示 功能 说 明 ， 如 图 20-96 所 示 。 
功能 说 明 界 面 显 示 5s 后 或 单 击 此 界面 ， 在 主屏 幕 上 显示 界面 如 图 20-97 所 示 。 


功能 说 明 : 

此 应 用 可 设置 监测 对 象 所 
处 的 地 理 围栏 , 并 实时 监测 
对 象 的 位 置 是 否 处 在 地 理 围 
栏 之 内 , 如 果 不 在 地 理 围栏 
之 内 , 会 自动 向 设置 的 手机 E 二 
号 码 拨打 电话 和 发 送 短信 。 


请 设置 通知 手机 号 码 


图 20-96 ”功能 说 明 界 面 图 20-97 ”定位 应 用 主屏 幕 界 面 1 


因为 必须 设置 通知 手机 号 码 ， 和 否则 此 应 用 不 能 起 到 应 有 的 作用 ， 所 以 文本 输入 框 只 有 确 
定 按钮 ， 没 有 取消 按钮 。 如 果 设 置 过 通知 手机 号 码 ， 则 在 启动 应 用 的 时 候 ， 在 主 界面 不 显示 
此 文本 输入 框 。 

定位 成 功 后 ， 显 示 界 面 如 图 20-98 所 示 。 
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围栏 中 心 位 置 : 上 海 市 普陀 区 长 征 镇 建 德 花 
玫瑰 苑 


a SH “Eo 
2 

(®) 

B / = 
VE } 


- - E 
520) AP 


a7 e/a 


KAZAA L 
a * 
汇金 百货 É 


Lege | 
海 虹桥 国际 机 场 
06 7520 


nm A 


图 20-98 ”定位 应 用 主屏 幕 界面 2 


2. 主屏 幕 界面 及 功能 实现 
1) 界面 布局 如 图 20-99 所 示 。 
2) 界面 使 用 的 组 件 列 表 如 图 20-100 所 示 。 


功能 说 明 : \n 此 应 用 可 设置 
监测 对 象 所 处 的 地 理 围栏 ， 

并 实时 监测 对 象 的 位 置 是 否 
处 在 地 理 围栏 之 内 ， 如 果 不 
在 地 理 围栏 之 内 ， 会 自动 向 


设置 的 手机 号 码 氢 打 电话 和 
发 送 短信 。 


all 


图 20-99 定位 应 用 主屏 幕 界面 布 
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组 件 列表 
© Screen] 
功能 说 明 
由 水 平 布局 1 
加 weoi 
型 JSONCreatel 
国 web 客 户 详 1 
对 话 框 1 
™S Systemlnfol 
型 LocationStatel 
位置 传 感 器 1 
= SystemSettings1 
3 定位 计时 器 
微 数据 库 1 
型 NetworkState1 
型 AirPlaneState1 
短信 收发 器 1 
型 FirstRun1 
) 初始 计时 器 
) 轮 询 计时 器 
电话 拨号 器 1 
™ MobilePhoneNumber1 


Activity 启 动 器 1 


R] 


20-100 定位 应 用 主屏 幕 的 组 件 列表 


组 件 的 属性 设置 见 表 20-10。 


表 20-10 定位 应 用 主屏 幕 的 组 件 属性 


组 件 属性 
组 件 名 称 
属性 名 称 属性 值 
a 位 vl. 
应 用 说 明 ane 
应 用 名 称 定位 
到 标 dingwei.png 
Screen! 是 否 显示 设置 菜单 是 
是 否 显示 更 新 版 本 菜单 是 
窗口 大 小 动 调 整 
标题 展示 Wi 
背景 颜色 青色 
功能 说 明 字号 28 
高 度 充满 
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组 件 属性 
组 件 名 称 
属性 名 称 属性 值 
宽度 充满 
功能 说 明 : \n 此 应 用 可 设置 监测 对 象 所 处 
的 地 理 围栏 ， 并 实时 监测 对 象 的 位 置 是 和 否 处 
功能 说 明 文本 在 地 理 围栏 之 内 ， 如 果 不 在 地 理 围栏 之 内 ， 
会 自动 向 设置 的 手机 号 人 码 拨 打 电 话 和 发 送 
短信 
宽度 充满 
水 平 布局 1 
可 见 性 T 
宽度 75 比例 
信息 展示 
文本 正在 定位 中 .… 
iI T 
功能 按钮 i 
文本 重新 定位 
mY T 
定位 计时 器 
司 间隔 30000 
mi HAT E 
初始 计时 器 
司 间隔 5000 
HNT 否 
轮 询 计时 器 
才 间 间隔 60000 
注 : 表 中 未 列 出 的 组 件 属性 ， 使 用 系统 提供 的 默认 值 。 
3) 功能 代码 。 
Q 使 用 到 的 全 局 变量 和 初始 值 见 表 20-11- 
表 20-11 定位 应 用 主屏 幕 的 全 局 变量 
变量 名 称 初 始 值 
经 度 0 
纬度 
获取 坐标 次 数 0 
地 理 围栏 半径 0 
围栏 个 数 0 
gid i 
设置 参数 <“ 
请 求 名 称 . 
经 纬度 < 
服务 器 返回 的 数据 列表 FIK 


@ 屏幕 初始 化 时 运行 的 代码 如 区 
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20-101 所 示 。 


= -初始 化 
WT | 四 如 果 
则 


字符 串 比 较 ,调用 .GetLocationState E3 [开启 
Eo 
\ 调 用 


否则 调用 GHAD .显示 选择 对 话 框 


图 20-101 


定位 应 用 初始 化 代码 
在 初始 化 的 时 候 ， 首 先 判断 是 否 开启 了 定位 功能 ， 只 有 开启 了 定位 功能 ， 才 会 继续 运行 
主流 程 代码 ， 否 则 显示 选择 对 话 杠 ， 提 示 用 户 开启 定位 功能 。 

© “初始 化 ”过 程 的 功能 代码 如 图 20-102 所 示 。 


加 exe O14 | 
执行 语句 (I 调用 JsFrstRun |E E 


图 20-102 “初始 化 ”过 程 的 功能 代码 
在 初始 化 的 时 候 ， 首 先 判 断 应 用 是 否 是 第 一 次 运行 ， 如 果 是 第 一 次 运行 ， 则 启动 “初始 
计时 器 ”， 在 屏幕 上 显示 功能 说 明文 字 5s; 否则 不 显示 功能 说 明文 字 ， 调 用 “可 见 性 设置 ” 
和 “初始 化 数据 ”两 个 过 程 。 

@“ 初 始 计 时 器 ”的 功能 代码 如 图 20-103 所 示 。 


= We Tas ~ 
WI 调用 Tat aS 


图 20-103 “初始 计时 器 ”的 功能 代码 


功能 说 明文 字 只 显示 5s， 所 以 计时 器 时 间 到 后 ， 停 止 计时 
“可见 性 设置 ”过 程 的 功能 代码 如 图 20-104 所 示 。 


©) Eve OMRE 


执行 语句 (RE ES. CMD 为 AEB 
(2E Cera CD >» S 
Ei vene e E 


Einne Kemm E 


图 20-104 “可 见 性 设置 ”过 程 的 功能 代码 
“水 平 布局 1” 和 “Web 浏览 框 1” 两 个 组 件 默 认 不 显示 ， 在 显示 完 功 能 说 明文 字 后 ， 隐 
藏 “ 功 能 说 明 ” 标 签 ， 显 示 这 两 个 组 件 ， 并 启动 “定位 计时 器 ”， 轮 询 定位 结果 《位 置 传 感 
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器 默认 是 启用 状态 )。 
@“ 初 始 化 数据 ”过 程 的 功能 代码 如 图 20-105 所 示 。 


(6) 定义 过 程 


执行 语句 im COREL 4 AAG 


标签 EE” 
| 无 标签 时 返回 值 | “图 ” 
G) MA Tse BREE ae Qc o 
E phonenumber J 
无 标签 时 返回 值 | “@” 


WE HA sea ASS ~ 
ee 


图 20-105 “初始 化 数据 ”过 程 的 功能 代码 


a 


“ 微 数据 库 1” 的 标签 “gid” 存 储 的 值 是 创建 围栏 成 功 后 ， 服 务 器 返回 给 App 的 地 到 
栏 的 全 局 id。 

“ 微 数据 库 1” 的 标签 “phonenumber” 存 储 的 值 是 通知 手机 号 码 ， 如 果 值 为 定 ， 则 调用 
“设置 通知 手机 号 码 ” 过 程 ， 请 用 户 设 置 通知 手机 号 码 。 

(“设置 通知 手机 号 码 ” 过 程 的 功能 代码 如 图 20-106 所 示 。 


HA CGHED BASANE 


消息 
标题 
允许 撤销 | 


图 20-106 “设置 通知 手机 号 码 ” 过 程 的 功能 代码 


因为 必须 要 设置 通知 手机 号 码 ， 否 则 此 应 用 无 法 起 到 应 有 的 作用 ， 所 以 文本 对 话 框 不 能 
被 允许 撤销 。 
(@@ “查询 围栏 ”过 程 的 功能 代码 如 图 20-107 所 示 。 


执行 语句 [ 如 果 FOREM :AirPlaneState1 GetAirPlaneState EED " EFJ” 


m3) aR |) Cee conser 下 > 
由 oL WET alobal gid ~ | #~ "e: | 
则 TREE 


图 20-107 “查询 围栏 ”过 程 的 功能 代码 
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如 果 用 户 没 有 打开 定位 功能 或 未 连接 网 络 ， 则 会 显示 选择 对 话 框 ， 提 示 用 户 ; 如 果 用 户 
单 击 “ 确 定 ” 按 钮 ， 则 会 跳 转 到 系统 设置 界面 。 

如 果 打 开 定 位 功能 和 连接 网 络 了 ， 且 从 “ 微 数据 库 1” 组 件 中 获取 的 gid 数据 不 为 空 
则 会 向 服务 器 发 送 请 求 ， 查 询 此 gid 值 对 应 的 地 理 围 栏 是 否 还 存在 。 

中 未 显示 完整 的 字符 串 内 容 为 

http://restapi.amap.com/v4/geofence/meta?key=120eb06f3c657b3 1293d2a727f959adb&gid= 

(其 中 的 key 值 是 在 高 德 网 站 申请 的 ) 

@@“ 对 话 框 1” 选 择 对 话 框 的 功能 代码 如 图 20-108 所 示 。 


4 GHID 选择 完成 
选择 值 Oo 
Aa \(o) MR ssi hse Go ‘ela’ 


| | 
则 调用 -SystemSettings 
E : 


图 20-108 选择 对 话 框 的 功能 代码 
“HTTP 请 求 ” 过 程 的 功能 代码 如 图 20-109 所 示 。 


© eae Guts D ES 
执行 语句 | 设置 UAEM .CL 为 | a URL ~ | 
| 调用 UCE .执行 GET 请 求 
C T global 请 求 名 称 E area ~) 


图 20-109 “HTTP 请 求 ”过 程 的 功能 代码 


因为 有 多 处 需要 向 服务 器 发 送 GET 请 求 ， 所 以 封装 一 个 过 程 函 数 ， 以 方便 使 用 。 参 数 
“请 求 名 称 ” 表 明 调 用 的 是 高 德 提供 的 哪个 Web 服务 器 API HTTP 接口 ， 在 这 个 过 程 中 ， 把 
请 求 名 称 ” 值 赋值 给 全 局 变量 “请 求 名 称 ” 以 方便 在 解析 服务 器 返回 的 数据 时 使 用 。 
“定位 计时 器 ”的 功能 代码 如 图 20-110 所 示 。 


ACERT ns ee o ED mr ees o 


则 BEELER 


图 20-110 “定位 计时 器 ”的 功能 代码 


233 


“定位 计时 器 ”的 时 间 间 隔 是 308， 每 隔 30s 会 查询 “位 置 传感器 1” 的 纬度 和 经 度数 值 
是 否 都 是 0， 如 果 两 个 都 不 是 0， 则 停止 计时 ， 并 向 服务 器 发 送 请 求 把 GPS 坐标 数值 转换 成 
高 德 使 用 的 坐标 数值 。 

累计 共 轮 询 10 次 ， 也 就 是 Smin， 如 果 Smin 后 还 不 能 获取 到 经 度 和 纬度 坐标 ， 则 停 1 
计时 ， 提 示 用 户 “ 定 位 失败 ” 并 且 “ 功 能 按钮 ” 变 为 可 单 击 状态 ， 用 户 可 单 击 此 按钮 重新 
定位 。 

图 中 未 显示 完整 的 字符 串 内 容 为 

http://restapi.amap.com/v3/assistant/coordinate/convert?key=120eb06f3c657b3 1293d2a727f95 
9adb&locations= 

O “功能 按钮 ”的 功能 代码 如 图 20-111 所 示 。 


= 


ACAR 字符 申 比较 OCDE 
Wo WA GIS .显示 文本 对 话 杠 


图 20-111 “功能 按钮 ”的 功能 代码 

此 功能 按钮 有 两 个 作用 : 重新 定位 和 设置 地 理 围 栏 半径 ， 用 户 单 击 此 按钮 时 ， 根 据 此 按 
钮 的 文本 ， 执 行 不 同 的 代码 。 

曲 “ 对 话 框 1” 文 本 对 话 框 的 功能 代码 如 图 20-112 所 示 。 


对 话 框 1= BARR 
响应 


和 否则” 调用 CHAD .显示 警告 信息 
通知 


图 20-112 “对 话 框 1” 文 本 对 话 框 的 功能 代码 
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在 此 应 用 中 ， 有 两 个 地 方 用 到 文本 对 话 框 : 设置 围栏 半径 和 设置 通知 手机 号 码 ， 全 局 变 
量 “ 设 置 参 数 ” 用 于 标识 是 设置 哪个 参数 。“Screen1” 屏 幕 进入 运行 状态 时 会 调用 高 德 提 供 
的 Web 服务 器 API 查询 围栏 HTTP 接口 ， 查 询 是 否 已 经 设置 过 地 理 围栏 ， 并 把 服务 器 返回 
的 围栏 个 数值 赋值 给 全 局 变量 “围栏 个 数 ”。 
如 果 此 变量 的 值 为 1， 说 明之 前 已 经 设置 过 围栏 ， 在 设置 完 围栏 半径 后 ， 调 用 高 德 提 供 
的 Web 服务 器 API 更 新 围栏 HTTP 接口 ， 更 新 围栏 数据 ;和 否则， 调用 创建 围栏 HTTP 接 
， 创 建新 围栏 。 
因为 必须 要 设置 通知 手机 号 码 ， 和 否则 此 应 用 无 法 起 到 应 有 的 作用 ， 所 以 在 用 户 设置 通知 
手机 号 码 失 败 后 ， 会 再 调用 “设置 通知 手机 号 码 ” 过 程 ， 让 用 户 设置 通知 手机 号 人 码 。 
“地 理 围 栏 ” 过 程 的 功能 代码 如 图 20-113 所 示 。 


可 MEOH CEED 
TEA OME Het (Ere EM ‘OL 


Et wos . (E373 为 (9) SL BRE Nip restapiamap 
FT global gid ~ | 


IEE 


[QHR scene (EE eM * oma: 


Wo WA UEH :执行 POST 文本 请 求 


MA | A CSOSA -JSONtoString 


BM 调用 UAE 执行 PATCH 文本 请 求 
L XA .SONCreatef JSONtoString 


SEMMA | MEE 
调用 GHAD . 显 示 进 程 对 话 框 


标题 “ 


图 20-113 “地 理 围栏 ”过 程 的 功能 代码 


创建 围栏 是 调用 高 德 提供 的 Web 服务 器 API 查询 围栏 HTTP 接口 ， 更 新 围栏 是 调用 高 
德 提供 的 Web 服务 器 API 更 新 围栏 HTTP 接口 ， 两 者 的 代码 类 似 ， 都 需要 向 服务 器 发 送 
JSON 文本 ， 所 以 把 代码 合并 为 一 个 过 程 函 数 。 

这 个 过 程 的 参数 “请 求 名 称 ” 用 于 标识 是 创建 围栏 还 是 更 新 围栏 。 

中 创建 围栏 时 ， 未 显示 完整 的 字符 串 内 容 为 

http://restapi.amap.com/v4/geofence/meta?key=120eb06f3c657b3 1293d2a727f959adb 

更 新 围栏 时 ， 未 显示 完整 的 字符 串 内 容 为 

http://restapi.amap.com/v4/geofence/meta?key=120eb06f3c657b3 1293d2a727f959adb& gid= 

D “AE ISON 字符 串 ” 过 程 的 功能 代码 如 图 20-114 所 示 。 

“Web 客户 端 1” 的 功能 代码 如 图 20-115 所 示 。 
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行 语 句 | 调用 .CreateJSONObject 
| 调用 PutObjectValue 
名 称 “ 
objectValue i 
| 调用 ‘PutObjectValue 
名 称 | 


objectValue 
| 调用 ‘PutObjectValue 
名 称 
objectValue 
| 调用 PutObjectValue 
ARO “ 
objectValue FE 


图 20-114 “创建 ISON 字符 串 ” 过 程 的 功能 代码 


.解码 JSON 文 本 
JSON 文 本 
调用 CEHE? .关闭 进程 对 话 框 


图 20-115 “Web 客户 端 1” 的 功能 代码 
“解析 数据 ”过 程 的 功能 代码 如 图 20-116 所 示 。 


O ENTE GHETE 
执行 语句 (o) MR Eee as A:T global RSA ~ =~] 
则 (如果 字符 串 比 较 在 键 值 对 取 global RARE.. 
GWAR FERE 朋友 global 请求 名 称 E 
则 (如果 在 键 值 对 取 global 服务 器 返回 的 数据 列表 .… 
global 请求 名 称 -人 二 
W (R 在 键 值 对 取 global 服务 器 返回 的 数据 列表 .，- 


SN MR 字符 中 比较 REESE ED 
则 (aR 在 键 值 对 取 global 服务 器 返回 的 数据 列表 ..，~ 
obal 请 求 名 和 
则 (aR 在 键 值 对 取 global 服务 器 返回 的 数据 列表 < 
LT aS Wt Tess global 请 求 名 称 I =~) 


如 果 字符 串 比 较 在 键 值 对 取 global 服务 器 返 .… 


图 20-116 “解析 数据 ”过 程 的 功能 代码 


在 此 过 程 中 ， 全 局 变量 “请 求 名 称 ” 标 识 服务 器 是 响应 高 德 提 供 的 哪个 Web 服务 器 API 
HTTP 接口 返回 的 数据 。 
具体 的 数据 解析 代码 如 图 20-117 一 图 20-122 所 示 。 
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Cae, FFE AE ED 

oE EET “= 153) eE 
返回 
为 | 


Ceres: = ae 
”| ， 如 未 找到 则 返回 “ 


ER global f 


否则 调用 CGHED .显示 敬告 信息 
通知 G 在 键 值 对 
中 查找 关键 字 
| ， 如 未 找到 则 返回 


图 20-117 数据 解析 代码 1 


调用 高 德 提供 的 Web 服务 器 API 查询 围栏 HTTP 接口 向 服务 器 发 送 请 求 后 ， 如 请 求 成 
功 ， 服 务 器 返回 数据 中 的 “total_record” 字 段 数 值 表明 了 是 否 存 在 围栏 ， 图 20-117 中 代码 
把 “total record” 字 段 数值 赋值 给 了 全 局 变量 “围栏 个 数 ”， 以 方便 在 其 他 地 方 使 用 。 


so) oe Wai caus. T ooa een ~ =~ ae Zines ae 
则 | 人) 如 果 res 


|, Mees 
设置 global ZAR pz 


EE esapi amap comnvageocoderegeomey=150 E 


-访问 网 页 
URL 网 址 


否则 调用 GHAD .显示 警告 信息 


， 如 未 找到 则 返回 


图 20-118 数据 解析 代码 2 


调用 高 德 提供 的 Web 服务 器 API 坐标 转换 HTTP 接口 向 服务 器 发 送 请 求 后 ， 如 请 求 成 
功 ， 服 务 器 返回 数据 中 的 “locations” 字 段 数 值 就 是 转换 后 的 经 纬度 。 

在 获取 到 转换 后 的 经 纬度 后 ， 调 用 Web 服务 器 API 逆 地 理 编 码 HTTP 接口 和 静态 地 图 
HTTP 接口 ， 向 服务 器 发 起 请 求 。 
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图 中 未 显示 完整 的 字符 串 内 容 为 
http://restapi.amap.com/v3/geocode/regeo?key=120eb06f3c657b3 1293d2a727f959adb&location= 


ENDAR yete | MEO E 


w fis aR 本 了 p: 
中 查找 关键 字 S 
， 如 未 找到 则 返回 


否则 ” 调用 GHAD .显示 警告 信息 
通知 | 
中 查找 关键 字 
， 如 未 找到 则 返回 


图 20-119 数据 解析 代码 3 


调用 高 德 提供 的 Web 服务 器 API 逆 地 理 编 码 HTTP 接口 向 服务 器 发 送 请 求 后 ， 如 请 求 
成 功 ， 服 务 器 返回 数据 中 的 “formatted_address” 字 段 数值 就 是 当前 位 置 的 具体 地 址 信息 。 

在 获取 到 地 址 信息 后 ， 设 置 “ 功 能 按钮 ”的 状态 为 启用 ， 按 钮 文本 设置 为 “围栏 半 
径 ” 此 时 用 户 可 设置 地 理 围栏 半径 。 


WAR 字 符 申 比较 ol 
了 rmso] 
MaRa CE 


， 如 未 找到 则 返回 ， 
ae Cr 
eee C 

， 如 未 找到 则 返回 


图 20-120 数据 解析 代码 4 


238 


调用 高 德 提供 的 Web 服务 器 API 创建 围栏 HTTP 接口 向 服务 器 发 送 请 求 后 ， 如 请 求 成 
功 ， 服 务 器 返回 数据 中 的 “gid” 字 段 数值 就 是 围栏 全 局 id。 调 用 “ 微 数据 库 1” 组 件 ， 把 全 
局 id 保存 在 设备 中 ， 以 便 下 次 使 用 应 用 时 ， 利 用 此 id 查询 是 否 存 在 地 理 围栏 。 

一 旦 创建 了 地 理 围栏 ， 就 启用 “ 轮 询 计时 器 ”， 每 隔 lmin 查询 下 当前 位 置 是 否 在 地 理 围 
栏 内 。 


SU, MR PREBLE 让 取 
N (C ORT pete | 


| | ， 如 未 找到 则 返回 . 
CE septi 0 global 服务 可 BE | 


G i a B message 四 
: ARRIM notiound " 
则 ” 调用 GHAD. IRESES 
| | "E cil TE Etar 成 功 iy 
设置 OTIT IE 


SU 调用 GHAD. Eresas 
ma 


ESET a not ound W 


图 20-121 数据 解析 代码 5 


更 新 围栏 成 功 后 ， 也 要 局 用“ 轮 询 计时 器 ”， 每 隔 lmin 查询 下 当前 位 置 是 否 在 地 理 围 
栏 内 。 


ee ME es MEE ED 
WW fs) WR 字符 串 比较 ol oT T 


ORE 
Mo" Gio Hes- 
am i 


通知 we 


了 了 so 
C MARANER ”Cg 


图 20-122 ”数据 解析 代码 6 
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调用 高 德 提供 的 Web 服务 器 API 创建 围栏 HTTP 接口 向 服务 器 发 送 请 求 后 ， 如 请 求 成 
功 ， 服 务 器 返回 数据 中 如 果 没 有 “nearest fence_distance” 字 段 ， 表 明 当 前 位 置 在 地 理 围 栏 
内 ， 否 则 表明 当前 位 置 在 地 理 围 栏 外 ， 此 时 调用 “报警 ”过 程 ， 向 设置 的 手机 号 码 拨打 电话 
和 发 送 短信 。 

“ 轮 询 计时 器 ”的 功能 代码 如 图 20-123 所 示 。 


= -计时 


OELE: http://restapi.amap.com/v4. 


调用 Systeminfol = .GetIMEI 


iyi global 经 纬度 ~ 
j “ ” 


从 文本 | 调用 .GetSysTimeStamp 


图 20-123 “ 轮 询 计 时 器 ”的 功能 代码 


图 中 未 显示 完整 的 字符 串 内 容 为 
http://restapi.amap.com/v4/geofence/status?key=120eb06f3c657b3 1293d2a727f959adb&diu= 
“报警 ”过 程 的 功能 代码 如 图 20-124 所 示 。 


©) EMU 报警] 


执行 语句 | 设置 EE 


图 20-124 “报警 ”过 程 的 功能 代码 


@“ 设 置 ” 菜 单 的 功能 代码 如 图 20-125 所 示 。 


当 Screen! ~ . 单 击 
执行 \ 有 


设置 菜单 的 响应 函数 


外 5 A4 


图 20-125 定位 应 用 “设置 ”菜单 的 功能 代码 


@@“ 更 新 版 本 ”菜单 的 功能 代码 如 图 20-126 所 示 。 
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当 单 击 更 新 版 本 菜单 的 响应 函数 
MT (O) WR “字符 品 比较 |/ 调用 CEASA GetAirPlaneState E “EI” 


则 | 四 如果 DTNetwo -GetNetworkState | CELA" 
则 设置 ov Action ~ Boll 
E A Activity aaa A 效 为 
\ 调 用 [Activity 尼 动 器 1 ~ 启动 活动 对 象 


否则 调用 Gis .显示 选择 对 话 框 
I 


BW 调用 CHAD .显示 选择 对 话 框 
消息 


图 20-126 ”定位 应 用 “更 新 版 本 ”菜单 的 功能 代码 
Q 异常 处 理 的 功能 代码 如 图 20-127 所 示 。 


图 20-127 定位 应 用 主屏 幕 异 常 处 理 的 功能 代码 


在 应 用 运行 的 时 候 ， 尤 其 是 在 和 服务 器 交互 的 过 程 中 ， 可 能 会 遇 到 各 种 异常 ， 此 时 需要 
关闭 进程 对 话 框 ， 香 则 ， 即 使 应 用 不 能 正常 运行 ， 进 程 对 话 框 还 会 一 直 显示 。 
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